Content
# @continuewith/mcp
[MCP](https://modelcontextprotocol.io) server so coding agents (Cursor, Claude Code, Codex, …) can install and configure the [ContinueWith](https://continuewith.ai) AI handoff widget without guessing URLs or snippets.
Runs locally over stdio — no hosted OAuth required for the open-source npm package.
## Install (Cursor / Claude Desktop)
Add to your MCP config:
```json
{
"mcpServers": {
"continuewith": {
"command": "npx",
"args": ["-y", "@continuewith/mcp@latest"]
}
}
}
```
Or run directly:
```bash
npx @continuewith/mcp@latest
```
Node.js 18+.
## Tools
| Tool | Description |
|------|-------------|
| `get_agent_install_rule` | Default rule for agents to auto-install on marketing pages |
| `get_install_snippet` | Widget snippet for `html`, `nextjs`, or `astro` |
| `get_continuewith_docs` | Official doc URLs + default snippet |
| `install_continuewith_widget` | Runs `npx continuewith add` in a project directory |
| `search_ready_directory` | Search the [AI Ready Index](https://ready.continuewith.ai/ready/directory) (public JSON API) |
## Example agent flow
1. Agent calls `get_agent_install_rule` → paste rule into project context
2. Agent calls `install_continuewith_widget` with `projectPath` → patches layout/HTML
3. User replaces `cw_demo_public_key` with their [dashboard](https://continuewith.ai/dashboard) key
## Documentation
- [Agents & MCP setup](https://continuewith.ai/docs/agents)
- [MCP tools reference](https://continuewith.ai/docs/agents/mcp)
- [Install guide](https://continuewith.ai/docs/install)
- [Skills catalog](https://continuewith.ai/docs/skills)
- [Agent index (`llms.txt`)](https://continuewith.ai/llms.txt)
## Related packages
| Package | Purpose |
|---------|---------|
| [`continuewith`](https://www.npmjs.com/package/continuewith) | CLI — `npx continuewith add` |
| [`@continuewith/sdk`](https://www.npmjs.com/package/@continuewith/sdk) | Snippet & prompt helpers |
## Trust & security
**Runs locally:** The MCP server uses stdio only. It does not phone home with your project source.
**Network access (explicit, read-only public APIs):**
- `search_ready_directory` → `https://ready.continuewith.ai/api/ready/directory` (public directory JSON)
- `install_continuewith_widget` → spawns `npx continuewith@latest add` on **your machine** in the path you provide
**No secrets in this package:** No Stripe, Resend, Clerk, or database credentials. The default site key `cw_demo_public_key` is a public demo identifier — replace it for production.
**You control paths:** Only pass `projectPath` values you trust — the install tool modifies files in that directory.
- [Security](https://continuewith.ai/security)
- [Privacy](https://continuewith.ai/privacy)
- [Terms](https://continuewith.ai/terms)
## Community
- Website: [continuewith.ai](https://continuewith.ai)
- X: [@continuewithai](https://x.com/continuewithai)
- Reddit: [@continuewithai](https://www.reddit.com/user/continuewithai)
- AI Ready Index: [ready.continuewith.ai](https://ready.continuewith.ai)
## License
MIT © [ContinueWith](https://continuewith.ai)
