{
  "markdown": "# crixin\n\n**The MCP toolkit for AI agents.** Two MCPs in one npm package, sharing one local SQLite, installing into the same MCP-aware hosts you already use.\n\n- **Voice MCP** — give your AI a phone line. Real outbound calls + SMS + transcription through your own Twilio.\n- **Coder MCP** — give your AI a memory. Reads back every Claude Code, Codex CLI, and Cursor session you've ever had.\n\n[![npm version](https://img.shields.io/npm/v/crixin.svg?style=flat&color=f5b452&labelColor=0b0d12)](https://www.npmjs.com/package/crixin)\n[![npm downloads](https://img.shields.io/npm/dm/crixin.svg?style=flat&color=7aa2f7&labelColor=0b0d12)](https://www.npmjs.com/package/crixin)\n[![license](https://img.shields.io/npm/l/crixin.svg?style=flat&color=7bd88f&labelColor=0b0d12)](LICENSE)\n[![node](https://img.shields.io/node/v/crixin.svg?style=flat&color=e0af68&labelColor=0b0d12)](https://nodejs.org)\n\n![crixin — give your AI a phone and a memory. Local-first MCP toolkit.](https://crixin.com/og-image.png)\n\n> Local-first. Bring your own Twilio. Bring your own LLM. No SaaS in the middle.\n\n## Install\n\n```sh\nnpm i -g crixin\ncrixin install                # writes BOTH MCPs (voice + coder) into Claude Desktop, Claude Code, Cursor, Codex CLI\n```\n\nEscape hatches if you want one half only:\n\n```sh\ncrixin voice install          # only the phone half\ncrixin coder install          # only the memory half\n```\n\nFor Voice MCP, set Twilio creds in the env your AI host launches from:\n\n```sh\nexport TWILIO_ACCOUNT_SID=ACxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx\nexport TWILIO_AUTH_TOKEN=your_auth_token\nexport TWILIO_PHONE_NUMBER=+15555550100\nexport DEEPGRAM_API_KEY=...   # optional — needed for Voice Wrapped + Caller Archetype\n```\n\n### Platform mode (no Twilio account needed)\n\nDon't want to bring your own Twilio? Grab an API key from the Crixin dashboard and set it instead — all six voice tools route through Crixin's hosted platform:\n\n```sh\nCRIXIN_API_KEY=crx_live_... npx -y crixin voice mcp\n```\n\nNo `TWILIO_*` vars, no `DEEPGRAM_API_KEY` (transcription runs server-side). `CRIXIN_API_BASE` overrides the API origin if you need to. The geo-gate still runs locally — strict-consent destinations (US/UK/EU/AU) require `consented: true` either way.\n\nVerify before you dial:\n\n```sh\ncrixin voice doctor           # BYO: one GET against Twilio. Platform mode: checks your key + minute quota. No charges.\n```\n\nFor Coder MCP, ingest your AI coding history:\n\n```sh\ncrixin coder ingest           # pulls Claude Code, Codex CLI, Cursor sessions → ~/.crixin/crixin.db\n```\n\n### Remote MCP (nothing to install)\n\nThe same six voice tools are served over Streamable HTTP by the hosted platform. Point any MCP host at the endpoint with your `crx_live_…` key:\n\n```bash\nclaude mcp add --transport http crixin-voice https://crixin-platform.vercel.app/api/mcp \\\n  --header \"Authorization: Bearer crx_live_...\"\n```\n\nCursor / VS Code: add an HTTP MCP server with the same URL and `Authorization` header. ChatGPT: Settings → Connectors → Developer mode → add the URL. The endpoint is stateless (POST only); tool names, arguments and results are identical to the local server.\n\n## What each MCP exposes\n\n### Voice MCP — `crixin-voice`\n\n| Tool | What it does |\n|---|---|\n| `make_call` | Outbound voice call. `to` + `prompt` (assistant speaks it; recipient response recorded), or raw TwiML. |\n| `get_call` | Status / duration / price / timestamps for one Call SID. |\n| `list_calls` | Recent calls — filter by `to` / `from` / `status` / `start_time_after`. |\n| `list_recordings` | Recordings + auth-protected media URLs for a Call SID. |\n| `transcribe_call` | Run a recording through Deepgram. 30+ languages including Arabic. |\n| `send_sms` | SMS / MMS through Twilio. Messaging Service support. |\n\n### Coder MCP — `crixin-coder`\n\n| Tool | What it does |\n|---|---|\n| `search_sessions` | Full-text search across every ingested Claude Code / Codex / Cursor session. |\n| `list_recent_sessions` | Newest sessions first, with project + token counts. |\n| `get_session` | Pull a full session transcript by ID. |\n| `stats` | Aggregate counts across the local SQLite store. |\n\n## Everyday commands\n\n```sh\n# Voice MCP\ncrixin voice doctor                # live-probe Twilio (no charges)\ncrixin voice call <to> [prompt]    # one-off call from the CLI\ncrixin voice sms  <to> <body>      # one-off SMS\ncrixin voice ingest                # pull recent Twilio calls + Deepgram transcripts → local SQLite\ncrixin voice wrapped --year 2026   # annual recap (HTML) — heatmaps, archetype, top destinations\ncrixin voice archetype             # caller archetype reveal (Quick Pitcher / Patient Listener / …)\ncrixin voice mcp                   # run as a stdio MCP server (used by AI hosts via npx)\n\n# Coder MCP\ncrixin coder ingest                # ingest AI coding sessions → ~/.crixin/crixin.db\ncrixin coder search <query>        # CLI search across sessions\ncrixin coder dashboard             # local Hono dashboard on 127.0.0.1\ncrixin coder wrapped --year 2026   # annual recap (HTML) — top projects, monthly bars, archetype\ncrixin coder archetype             # 11 archetypes — 5 for you, 6 for your AI\ncrixin coder mcp                   # run as a stdio MCP server (used by AI hosts via npx)\n\n# Sync (Pro) — one account, every machine, same session list\ncrixin sync status                 # device + link state + queue counts (works on Free)\ncrixin sync link                   # opens browser to approve this device\ncrixin sync push                   # send metadata to the server (manual, foreground)\ncrixin sync pull                   # fetch peer metadata into the local inbox\ncrixin sync inbox                  # latest pulled records from your other machines\n```\n\n> **Metadata only.** Sync v1 shares the session index across your machines — never message bodies, transcripts, credentials, phone numbers, or free-text tags. Your code never leaves your disk.\n\n## Per-host install (manual)\n\n```sh\n# Claude Code\nclaude mcp add crixin-voice -- npx -y crixin voice mcp\nclaude mcp add crixin-coder -- npx -y crixin coder mcp\n\n# Cursor — append to ~/.cursor/mcp.json\n{\n  \"mcpServers\": {\n    \"crixin-voice\": { \"command\": \"npx\", \"args\": [\"-y\",\"crixin\",\"voice\",\"mcp\"] },\n    \"crixin-coder\": { \"command\": \"npx\", \"args\": [\"-y\",\"crixin\",\"coder\",\"mcp\"] }\n  }\n}\n\n# Codex CLI — append to ~/.codex/config.toml\n[mcp_servers.crixin-voice]\ncommand = \"npx\"\nargs = [\"-y\",\"crixin\",\"voice\",\"mcp\"]\n\n[mcp_servers.crixin-coder]\ncommand = \"npx\"\nargs = [\"-y\",\"crixin\",\"coder\",\"mcp\"]\n```\n\nOr just run `crixin install` and let it wire everything for you.\n\n## Wrapped (the year-end receipt)\n\nBoth halves emit a self-contained HTML report.\n\n```sh\ncrixin voice wrapped               # → ./crixin-voice-wrapped-2026.html\ncrixin coder wrapped               # → ./crixin-coder-wrapped-2026.html\n```\n\nHour-of-day heatmaps, monthly bars, archetype reveal (Patient Listener / Hard Closer / Ducker / Cowboy / Architect / …), top destinations or top projects, top languages or top models. PII-stripped. Shareable as a screenshot. No upload.\n\n## Stack\n\n- **STT**: Deepgram Nova-2 (optional — `DEEPGRAM_API_KEY`).\n- **TTS**: Twilio Polly + Google neural voices via TwiML `<Say>`. (Polly.Joanna-Neural for en-US, Polly.Hala-Neural for ar-EG, Polly.Lucia-Neural for es-ES, etc.)\n- **LLM**: none in the open-source call path — your AI host decides what to say. Pro tier can plug in hosted Wrapped + memory sync.\n- **Storage**: local SQLite at `~/.crixin/crixin.db`. Tables: `voice_calls`, `voice_recordings`, `sessions`, `messages`.\n\n## Pricing\n\n| Tier | Price | What you get |\n|---|---|---|\n| **Open Source** | Free forever | Both MCPs, all tools, all Wrapped, all archetypes. MIT-licensed. Bring your own Twilio. |\n| **Crixin Unlimited** | $9.99/mo | Hosted calling with no Twilio account: unlimited calls, one monthly fee. Premium voice for the first 60 minutes each month, then standard, then basic — the call always gets made. One call at a time per account. Platform mode (`CRIXIN_API_KEY`) and the remote MCP run on this plan. |\n\nExisting Coder Pro ($5/mo: hosted Wrapped + `crixin sync`) keeps working and is being folded into Unlimited.\n\n[See full pricing](https://crixin-platform.vercel.app/pricing).\n\n## Privacy posture\n\n- Zero servers between you and Twilio. Calls hit `api.twilio.com` directly with your auth header.\n- Coder MCP reads JSONLs your AI host already wrote to your disk. Nothing leaves your machine.\n\n## Privacy Policy\n\nFull policy: <https://crixin.com/legal/privacy> (effective June 17, 2026). In short:\n\n- **Local mode (BYO Twilio):** this package collects nothing. Calls go straight to Twilio with your credentials; call history and transcripts live in `~/.crixin/crixin.db` on your machine. Your AI host sees tool results the same way it sees any other tool.\n- **Hosted mode (`CRIXIN_API_KEY` or the remote MCP):** the Crixin platform stores call metadata (numbers, timestamps, duration, status), recordings and transcripts you request, and usage counters for billing. Calls are carried by Twilio; transcription runs on Deepgram; hosted voice calls use OpenAI, Deepgram and ElevenLabs models. We do not sell data.\n- **Retention:** account data while the account is active, deleted within 30 days of account deletion; recordings and transcripts deleted with the account; payment records as required by law.\n- **Contact:** privacy@crixin.com (privacy requests) · help@crixin.com (support).\n- Transcripts and call recordings stay in your Twilio account and your local SQLite.\n- No telemetry. No upload. No analytics pixels.\n\n## Geo-gate (Voice MCP)\n\nOutbound calls to strict-consent jurisdictions (US, Canada, UK, IE, FR, ES, IT, NL, AU, NZ) require an explicit `--consented` flag or `consented: true` in the MCP tool args. Permissive jurisdictions (Egypt, UAE, KSA, Jordan, Kuwait, Qatar, Bahrain, Oman, Lebanon, Nigeria, ZA) dial without the flag. Germany is blocked outright. Override with `CRIXIN_VOICE_ALLOWED_CC`.\n\n## Docs\n\n[Install](https://crixin.com/install) · [Voice MCP](https://crixin.com/voice) · [Coder MCP](https://crixin.com/coder) · [Wrapped](https://crixin.com/wrapped) · [Archetype](https://crixin.com/archetype) · [Pricing](https://crixin.com/voice/pricing) · [FAQ](https://crixin.com/faq)\n\n## License\n\nMIT. Built by [@Mrdopplereffekt](https://github.com/Mrdopplereffekt).\n",
  "bytes": 10306,
  "sha": "f65df15f8ce369a818e04805224e1199990c1509d54a08743c268a007fc8a257",
  "repo_slug": "thelazizagroup/crixin",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_com_crixin_voice_c23af4e8/readme"
}