MCP ServerHTTPOfficialv1.0.0

Hekkova MCP Server

Mint moments—photos, videos, audio, text—permanently to the Polygon blockchain with IPFS storage, Lit Protocol encryption, and privacy tiers. For developers building AI agents that need immutable, encrypted memory.

com.hekkova/mcp

Hosted URL

https://mcp.hekkova.com/mcp

Transport

HTTP

Auth

No auth required

Hekkova repository at a glance

Live signal from GitHub, refreshed weekly.

Stars

0

Last commit

Apr 11, 2026

License

Language

TypeScript

What the Hekkova MCP server does

How models use it and what it is built for.

Mint moments—photos, videos, audio, text—permanently to the Polygon blockchain with IPFS storage, Lit Protocol encryption, and privacy tiers. For developers building AI agents that need immutable, encrypted memory.

Connect to Hekkova

Hosted endpoint — paste into any MCP client.

https://mcp.hekkova.com/mcp

Resources

Where to find authoritative docs and source for Hekkova.

Example prompts for Hekkova

Paste any of these into Agent Studio after connecting Hekkova.

  • Mint this photo to Polygon with new_moon privacy and tag it super_moon
  • Fetch and mint the og:image from this tweet URL with crescent phase access
  • List all my moments filtered by blue_moon category with pagination
  • Change my moment's privacy phase from new_moon to full_moon and check my credit balance

Documentation from project README

View on GitHub

Excerpted from the project's README — boilerplate sections (license, changelog, contributing) omitted for clarity.

Hekkova MCP Server

The permanent memory layer for AI agents. Connect any MCP-compatible AI (Claude, ChatGPT, Gemini, Cursor, custom agents) and mint moments — photos, videos, audio, text — permanently to the Polygon blockchain with IPFS + Filecoin storage, Lit Protocol encryption, and privacy tiers that let you control who sees what.


Quick Start

# 1. Install dependencies
npm install

# 2. Copy and configure environment variables
cp .env.example .env
# Edit .env with your Supabase, Thirdweb, Pinata, and Stripe credentials

# 3. Seed the local test account and API key
npm run seed

# 4. Start the development server
npm run dev
# → Server running at http://localhost:3000/mcp

Connect with Claude Desktop

Add this to your Claude Desktop config file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "hekkova": {
      "type": "url",
      "url": "http://localhost:3000/mcp",
      "headers": {
        "Authorization": "Bearer hk_test_local_dev_key_12345678"
      }
    }
  }
}

For production, replace the URL and API key:

{
  "mcpServers": {
    "hekkova": {
      "type": "url",
      "url": "https://mcp.hekkova.com/mcp",
      "headers": {
        "Authorization": "Bearer hk_live_YOUR_API_KEY"
      }
    }
  }
}

Get your API key at hekkova.com/dashboard/keys.


Tool Reference

Tool Description
mint_moment Mint media (photo, video, audio, text) permanently to Polygon. Encrypts based on phase, pins to IPFS, mints ERC-721 NFT. Returns a Block ID.
mint_from_url Fetch a public URL (tweet, Instagram post, image, web page) and mint it. Extracts og:title and og:image automatically.
list_moments Paginated list of all minted moments. Filterable by phase, category, or search query.
get_moment Full details for a single moment by Block ID: CIDs, transaction hash, phase, tags, and more.
update_phase Change a moment's privacy phase. Costs 1 credit (text/image) or 2 credits (video). Legacy Plan includes 10 free Phase Shifts/month.
export_moments Export all moments as JSON or CSV. Returns a 24-hour download URL with all Block IDs and IPFS CIDs.
get_balance Check remaining mint credits, current plan (free / arc_builder / legacy), and phase shift balance.
get_account Account identity: Light ID, display name, wallet address, default phase, and legacy plan status.

Privacy Phases

Phase Access Encryption
new_moon Owner only Lit Protocol (owner wallet ACC)
crescent Close circle (2–10 people) Lit Protocol (shared access conditions)
gibbous Extended group (up to 50) Token-gated via Hekkova ERC-721
full_moon Fully public None

Moment Categories

Category Meaning
super_moon Major life event
blue_moon Rare moment
super_blue_moon Once-in-a-lifetime
eclipse Time-locked — sealed until eclipse_reveal_date
null Uncategorized

Continue reading on GitHub

Hekkova MCP server — FAQ

Common questions about connecting and running Hekkova.

  • What is Hekkova MCP and why would I use it?

    Hekkova is a permanent memory layer for AI agents that mints media (photos, videos, audio, text) to the Polygon blockchain with IPFS + Filecoin storage and Lit Protocol encryption. Use it when you need your AI agent's memories to be immutable, encrypted, and owned by the user.

  • How do I authenticate and get an API key?

    Generate an API key at hekkova.com/dashboard/keys, then add it as a Bearer token in the Authorization header when connecting to the MCP server. For local development, run `npm run seed` to create a test key.

  • What are privacy phases and how do they work?

    Phases control who can access a minted moment: new_moon (owner only), crescent (2–10 people), gibbous (up to 50 with token-gating), and full_moon (public). Changing phases costs credits; the Legacy Plan includes 10 free phase shifts per month.

  • How much does it cost to mint moments?

    Pricing is credit-based: text/image mints cost 1 credit, videos cost 2 credits. The free Sandbox plan allows 1 mint/min for testing; paid plans and the Legacy Plan offer higher limits. Check your balance with the `get_balance` tool.

  • What happens if I hit the rate limit?

    Rate limits vary by plan (Sandbox: 10 req/min, Standard: 60 req/min, Legacy: 120 req/min). Every response includes X-RateLimit headers showing your remaining quota and reset time. Requests over the limit will be rejected.

Run Hekkova across 30+ AI models, side-by-side

Connect Hekkova to Claude, GPT, Gemini, DeepSeek and 30+ AI models in MCP Agent Studio. Compare answers side-by-side, save reusable agent presets, share runs — all in your browser, no install required.

Open Agent Studio

Related servers

More on MCP Playground