Recapfy logo

Recapfy

Ask questions about YouTube videos or retrieve timestamped transcripts through paid Solana USDC calls.

Install Recapfy

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "recapfy": {
      "command": "npx",
      "args": [
        "-y",
        "recapfy-mcp"
      ],
      "env": {
        "SVM_PRIVATE_KEY": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

Install not yet sandbox-tested— we haven't run this command through our automated sandbox yet. Not a red flag; we're working through the catalog.

Overview

The recapfy MCP server lets MCP clients ask questions about YouTube videos and retrieve full transcripts. It runs locally through an npm package and sends requests to Recapfy's API. Each tool call is paid automatically in USDC on Solana through x402, using a wallet supplied by the operator. Reach for it when an agent needs video-specific answers or transcript data and the payment requirement is acceptable.

Use cases

  • Ask an agent questions about a YouTube video
  • Retrieve a video's timestamped transcript
  • Extract title, channel, and duration metadata
  • Inspect available tools with the MCP Inspector

Key features

  • Question answering for YouTube videos
  • Full timestamped transcript retrieval
  • Automatic USDC payments on Solana
  • Dynamic pricing based on answer length
  • Local npm-based MCP deployment

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 3d ago

Recent health check succeeded.

7/7 checks healthy over the last 46d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 13d ago via OSV.dev · recapfy-mcp (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars1Stargazers on the source repository.
npm downloads189Package downloads in the last 30 days.
Last commit3mo agoMost recent push to the default branch.

How Recapfy works

What the recapfy MCP server does

The recapfy MCP server exposes two Recapfy API operations to MCP-compatible clients: ask and get_transcript. Both accept an absolute HTTP or HTTPS YouTube URL. The first sends a question about the video and returns an answer as text. The second returns the complete transcript with timestamps, along with the video's title, channel name, and duration.

This is a locally launched server rather than a hosted MCP endpoint. The npm package is started by the MCP client, so the client process communicates with a local instance while that instance calls Recapfy's API.

Tools and capabilities

ask requires videoUrl and a non-empty prompt. It accepts an optional positive maxOutputTokens value, which defaults to 1024 and affects the quoted price. The response is returned after payment is settled.

get_transcript requires only videoUrl. Its readable output contains timestamped transcript segments. Structured output also includes a raw array whose entries contain timestampInSeconds and text.

The recapfy MCP server uses x402 payment handling for both operations. The API first responds with payment requirements, including the USDC amount. The client signs a gasless SPL-token transfer with the configured Solana wallet, retries the request, and receives the API response after verification and settlement. The facilitator sponsors the network fee, so the wallet does not need SOL, but it must hold USDC on Solana mainnet.

Setup and configuration

Install without cloning or building by configuring the client to run npx -y recapfy-mcp@latest. Set SVM_PRIVATE_KEY to the wallet's base58-encoded 64-byte secret key. A dedicated, low-balance wallet is appropriate because every invoked tool makes a real payment.

RECAPFY_API_BASE_URL optionally replaces the default API URL, https://api.recapfy.ai, which is useful for local development. RECAPFY_ALLOW_INSECURE_TLS=1 permits self-signed TLS certificates for local HTTPS development.

Use the @latest package tag so npx checks for the current published package. After an update, fully restart the MCP client because clients read the tool list once per session. If the package remains stale, clear the npx cache and restart again.

Limitations and notes

Calls are not free: ask has a dynamic USDC price based on maxOutputTokens, while get_transcript has a flat USDC price. The amount is quoted by the API and paid before the result is returned. An unfunded wallet, an incorrect network, an invalid private key, or missing required input will prevent a call from succeeding.

The server requires Node.js 20 or newer. Use the MCP Inspector to browse the available tools without invoking them; running a tool with a funded wallet performs a real paid request. The project is licensed under MIT.

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Recapfy

recapfy is an MCP server that connects MCP-capable agents to Recapfy's YouTube video API. Its main tools are `ask`, which answers questions about a video, and `get_transcript`, which returns timestamped transcript data and video metadata. Calls are paid automatically in USDC on Solana through x402.

Install it by adding `npx -y recapfy-mcp@latest` as the MCP server command in your client configuration. Set `SVM_PRIVATE_KEY` to a base58-encoded Solana secret key, then restart the client. Node.js 20 or newer and a USDC-funded Solana mainnet wallet are required.

recapfy charges each tool call in USDC on Solana through x402. The `ask` price varies with `maxOutputTokens`, while `get_transcript` uses a flat price. The configured wallet signs the payment automatically, and the facilitator sponsors the Solana network fee.

Yes, recapfy works with Claude Desktop, Cursor, and Cline through their MCP configurations. It runs locally through npx, so the client launches the server process and reads its tools when the session starts. Restart the client after installing or updating the package.

Related MCP servers

Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewRecapfy AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/recapfy?style=directory)](https://allmcps.com/mcp/recapfy)
HTML Embed
<a href="https://allmcps.com/mcp/recapfy"><img src="https://allmcps.com/api/badge/recapfy?style=directory" alt="Recapfy on AllMCPs" /></a>