@kojimem/mcp

MCP server for kojimem — semantic memory for AI agents via x402 micropayments.

5 tools. One env var. Under two cents per session.

Setup

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "kojimem": {
      "command": "npx",
      "args": ["@kojimem/mcp"],
      "env": {
        "EVM_PRIVATE_KEY": "0x..."
      }
    }
  }
}

EVM_PRIVATE_KEY is a funded EVM wallet on Base Sepolia with USDC. Get test USDC from the Coinbase faucet.

Cursor / Windsurf / Any MCP Host

Same config pattern — point the MCP host at npx @kojimem/mcp with EVM_PRIVATE_KEY in the environment.

Tools

| Tool | Cost | Description | |------|------|-------------| | create_memory | $0.01 | Create a memory backpack. Returns a memory ID. | | remember | Free | Write facts into a memory. 1-100 per call. Zero inference cost. | | recall | $0.001–$0.005 | Ask a question, get a reasoned answer. Three tiers: fast, balanced, reasoning. | | extend_memory | $0.005 | Add more time before a memory expires. | | destroy_memory | Free | Delete a memory permanently. |

How It Works

Agent ──MCP──► @kojimem/mcp ──HTTP+x402──► api.kojimem.dev ──► OpenAI
                (local)                     (Fly.io)

• Paid tools (create, recall, extend): @x402/axios handles the 402→pay→retry cycle automatically. The agent just calls the tool.
• Free tools (remember, destroy): Signed with your wallet via EIP-191 (X-SIWX header).
• No accounts, no API keys. Your wallet is your identity.

Typical Session

create_memory(persona: "research", ttl: "1h")     → $0.010
remember(facts: ["...", "...", "..."])              → free
recall(question: "What did I find?", tier: "balanced") → $0.002
destroy_memory()                                   → free
                                            Total: $0.012

Personas

Choose a persona when creating a memory — it shapes how recall reasons across your facts:

default · research · coding · compliance · sales · support · medical

Environment Variables

| Variable | Required | Default | Description | |----------|----------|---------|-------------| | EVM_PRIVATE_KEY | Yes | — | EVM wallet private key (0x-prefixed) | | KOJIMEM_API_URL | No | https://api.kojimem.dev | API base URL |

Links

• kojimem.dev — Product site
• api.kojimem.dev/health — API status
• x402.org — Payment protocol

License

MIT