Summary
A shim over Clypt's public REST API that wires three operations into MCP: submit a podcast job from an RSS feed, audio URL, or video URL; poll for completion; and list your org's recent jobs. The pipeline is async and takes 2–5 minutes for audio sources, 10–12 minutes for video with an optional trailer. When a job finishes, you get back clips, show notes, a guest share link, and the full transcript. Sandbox keys with a clk_test_ prefix return deterministic fixtures so you can test the flow without burning transcription credits. Useful when you want Claude to turn a podcast episode into shareable clips without leaving the conversation.
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →
@useclypt/mcp-server
Model Context Protocol server for Clypt. Lets AI agents (Claude Desktop, Cursor, Claude Code, any MCP-aware client) submit a podcast URL and receive clips, an optional trailer, show notes, a guest-share link, and the transcript.
Pure shim over the public REST API at https://useclypt.com/api/v1 — three tools, no clever middleware.
Tools
| Tool | Wraps | Returns |
|---|---|---|
submit_job | POST /v1/jobs | { id, status: 'queued', ... } — kicks the pipeline. Wall-clock to terminal: ~2-5 min for audio/RSS sources, ~10-12 min for video + trailer. |
get_job | GET /v1/jobs/{id} | Current job state. When status='complete', output contains clips, optional trailer, guest_share_url, show_notes, transcript. When failed, error carries a code + message. |
list_jobs | GET /v1/jobs | Cursor-paginated list of the org's recent jobs. |
The flow is asynchronous: submit_job returns immediately with a queued id; the agent polls get_job until terminal. Once a webhook is registered against your org, job.completed and job.failed events fire on every terminal transition — register via the public API at POST /v1/webhooks (no MCP tool for this yet; coming in a later minor).
Try it
With the server configured in Claude Desktop, ask:
Use Clypt to clip this podcast and tell me when it's done: https://feeds.simplecast.com/abc123
Claude will call submit_job, get back a job id, poll get_job until terminal, and surface the clips + trailer + transcript inline. Wall-clock: ~2-5 min for audio/RSS, ~10-12 min for video + trailer.
Installation
npm install -g @useclypt/mcp-server
Or run without installing:
npx -y @useclypt/mcp-server
Configuration
Claude Desktop
~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):
{
"mcpServers": {
"clypt": {
"command": "npx",
"args": ["-y", "@useclypt/mcp-server"],
"env": {
"CLYPT_API_KEY": "clk_live_..."
}
}
}
}
Restart Claude Desktop. Then prompt: "Use Clypt to clip this podcast: ".
Cursor / Claude Code / other MCP hosts
Same recipe — the binary is mcp-server (or run without global install via npx -y @useclypt/mcp-server) and the only required env var is CLYPT_API_KEY.
Sandbox keys (free testing)
If your key starts with clk_test_ instead of clk_live_, every job returns a deterministic fixture instead of running the real pipeline. No transcription cost, no R2 storage cost, no Stripe charges. Useful for wiring up your agent before you commit to real submissions.
Fixture mapping:
source.type='video_url'(any URL) → success fixture with 3 clips + optional trailersource.type='audio_url'/rss_feed_url(URL without "fail") → success fixture- Any URL containing "fail" →
transcription_failederror fixture source.type='youtube_url'→youtube_ingestion_failederror fixture- Malformed URL →
invalid_source_urlvalidation error at submit
Get a sandbox key in seconds at useclypt.com/developers/signup — no credit card, no waiting list. Sandbox keys (prefix clk_test_) return deterministic fixtures so you can wire up your agent for free before swapping in a clk_live_ key.
Environment variables
| Variable | Required | Default | Purpose |
|---|---|---|---|
CLYPT_API_KEY | yes | — | Bearer token for the Clypt API. clk_live_* or clk_test_*. |
CLYPT_BASE_URL | no | https://useclypt.com | Override for staging or local development. Trailing slash is stripped. |
Development
npm install
npm run build
npm test # vitest unit tests with mocked fetch
npm run dev # tsc --watch
Smoke against the live API with the MCP inspector CLI:
npm run build
CLYPT_API_KEY=clk_test_xxx \
npx @modelcontextprotocol/inspector --cli node dist/index.js --method tools/list
Learn more
- API reference: useclypt.com/developers/docs
- Get a key: useclypt.com/developers/signup
- About Clypt: useclypt.com
License
MIT — see LICENSE.
Featured
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →Configuration
CLYPT_API_KEY*secretClypt API key. Get one at https://useclypt.com/developers. Use a clk_test_* sandbox key for free deterministic fixtures.
CLYPT_BASE_URLOverride the Clypt API base URL. Defaults to https://useclypt.com.
Registryactive
Package@useclypt/mcp-server
TransportSTDIO
AuthRequired
UpdatedMay 20, 2026