{
  "markdown": "# @useclypt/mcp-server\n\nModel 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.\n\nPure shim over the public REST API at `https://useclypt.com/api/v1` — three tools, no clever middleware.\n\n## Tools\n\n| Tool | Wraps | Returns |\n|---|---|---|\n| `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. |\n| `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`. |\n| `list_jobs` | `GET /v1/jobs` | Cursor-paginated list of the org's recent jobs. |\n\nThe 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).\n\n## Try it\n\nWith the server configured in Claude Desktop, ask:\n\n> *Use Clypt to clip this podcast and tell me when it's done: https://feeds.simplecast.com/abc123*\n\nClaude 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.\n\n## Installation\n\n```bash\nnpm install -g @useclypt/mcp-server\n```\n\nOr run without installing:\n\n```bash\nnpx -y @useclypt/mcp-server\n```\n\n## Configuration\n\n### Claude Desktop\n\n`~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\\Claude\\claude_desktop_config.json` (Windows):\n\n```json\n{\n  \"mcpServers\": {\n    \"clypt\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@useclypt/mcp-server\"],\n      \"env\": {\n        \"CLYPT_API_KEY\": \"clk_live_...\"\n      }\n    }\n  }\n}\n```\n\nRestart Claude Desktop. Then prompt: *\"Use Clypt to clip this podcast: <RSS or audio URL>\"*.\n\n### Cursor / Claude Code / other MCP hosts\n\nSame 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`.\n\n## Sandbox keys (free testing)\n\nIf 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.\n\nFixture mapping:\n- `source.type='video_url'` (any URL) → success fixture with 3 clips + optional trailer\n- `source.type='audio_url'` / `rss_feed_url` (URL without \"fail\") → success fixture\n- Any URL containing \"fail\" → `transcription_failed` error fixture\n- `source.type='youtube_url'` → `youtube_ingestion_failed` error fixture\n- Malformed URL → `invalid_source_url` validation error at submit\n\nGet a sandbox key in seconds at [useclypt.com/developers/signup](https://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.\n\n## Environment variables\n\n| Variable | Required | Default | Purpose |\n|---|---|---|---|\n| `CLYPT_API_KEY` | yes | — | Bearer token for the Clypt API. `clk_live_*` or `clk_test_*`. |\n| `CLYPT_BASE_URL` | no | `https://useclypt.com` | Override for staging or local development. Trailing slash is stripped. |\n\n## Development\n\n```bash\nnpm install\nnpm run build\nnpm test              # vitest unit tests with mocked fetch\nnpm run dev           # tsc --watch\n```\n\nSmoke against the live API with the MCP inspector CLI:\n\n```bash\nnpm run build\nCLYPT_API_KEY=clk_test_xxx \\\n  npx @modelcontextprotocol/inspector --cli node dist/index.js --method tools/list\n```\n\n## Learn more\n\n- API reference: [useclypt.com/developers/docs](https://useclypt.com/developers/docs)\n- Get a key: [useclypt.com/developers/signup](https://useclypt.com/developers/signup)\n- About Clypt: [useclypt.com](https://useclypt.com)\n\n## License\n\nMIT — see [LICENSE](LICENSE).\n",
  "bytes": 4331,
  "sha": "00e3ef06ace2e5c52a16bded47e462dcac1892bea8b5cfca950e0b8f45ea69d0",
  "repo_slug": "nelsonjordanme/clypt-mcp-server",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_nelsonjordanme_clypt_a830ca32/readme"
}