@continuewith/mcp

MCP server so coding agents (Cursor, Claude Code, Codex, …) can install and configure the ContinueWith 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:

config.json

{
  "mcpServers": {
    "continuewith": {
      "command": "npx",
      "args": ["-y", "@continuewith/mcp@latest"]
    }
  }
}

Or run directly:

Terminal

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 (public JSON API)

Example agent flow

Agent calls get_agent_install_rule → paste rule into project context
Agent calls install_continuewith_widget with projectPath → patches layout/HTML
User replaces cw_demo_public_key with their dashboard key

Documentation

Related packages

Package	Purpose
`continuewith`	CLI — `npx continuewith add`
`@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.

ContinueWith README