Recapfy MCP Server

Recapfy MCP

An MCP server that exposes Recapfy's paid ask endpoint as a tool — ask anything about a YouTube video (or get a summary) straight from an MCP-capable agent like Claude Desktop, Cursor, or Cline. It runs locally — there's no hosted Recapfy MCP endpoint; you launch your own copy.

Each call is paid in USDC on Solana (dynamic price, scales with maxOutputTokens), settled automatically via the x402 protocol. You bring your own wallet; you pay only for what you call.

📦 npm: recapfy-mcp

Prerequisites

• Node.js ≥ 20.
• A Solana wallet funded with USDC on mainnet. You do not need SOL for fees — the API's facilitator sponsors the network fee.
• That wallet's secret key, base58-encoded (the 64-byte form that Phantom's "Export Private Key" gives you, or solana-keygen).

⚠️ The key signs real payments. Use a dedicated low-balance wallet, never share it, and never commit it.

Install

No clone or build needed. Add this to your MCP client config (Claude Desktop: claude_desktop_config.json) and restart the client:

{
  "mcpServers": {
    "recapfy": {
      "command": "npx",
      "args": ["-y", "recapfy-mcp"],
      "env": {
        "SVM_PRIVATE_KEY": "<your base58 Solana secret key>"
      }
    }
  }
}

Configuration

Tool: ask

Returns the agent's answer as text. Payment is settled before the answer returns. The per-call price is dynamic: the API quotes the USDC amount in the 402 challenge based on maxOutputTokens, and your wallet pays whatever is quoted — so keep maxOutputTokens sensible.

How payment works

Built on the official Coinbase x402 v2 client packages (@x402/fetch, @x402/svm, @x402/core) plus @solana/kit for signing:

1. The tool POSTs to ${RECAPFY_API_BASE_URL}/api/v1/agents/ask.
2. The API replies 402 with requirements in the PAYMENT-REQUIRED header (exact SVM scheme, USDC, dynamic amount, and a facilitator feePayer that sponsors the network fee).
3. The wrapped fetch signs a gasless SPL-token transfer with your wallet and retries with the PAYMENT-SIGNATURE header.
4. The API verifies, settles, and returns the answer plus a PAYMENT-RESPONSE settlement header.

Verify it works

Inspect the tool without spending anything using the MCP Inspector (it only signs a payment when you actually invoke ask, so any key is fine just to browse):

SVM_PRIVATE_KEY=<key> npx @modelcontextprotocol/inspector npx -y recapfy-mcp

Open the printed URL → Tools → ask. Invoking it with a funded wallet performs a real paid call; verify the spend on a Solana explorer.

Troubleshooting

Development

git clone https://github.com/pedrot95dev/recapfy.mcp.git
cd recapfy.mcp
npm install
npm run build      # outputs dist/

Run a local checkout from your MCP client by pointing at the build:

{
  "mcpServers": {
    "recapfy": {
      "command": "node",
      "args": ["/absolute/path/to/recapfy.mcp/dist/index.js"],
      "env": {
        "SVM_PRIVATE_KEY": "<your base58 Solana secret key>"
      }
    }
  }
}

Releases are automated: publishing a GitHub Release runs .github/workflows/release.yml, which publishes to npm via OIDC trusted publishing (with provenance, no token).

License

MIT