MCP Server

Hooks capture context. MCP recalls it. ContextPilot ships a stdio MCP server that exposes compact search and memory tools to agents that support Model Context Protocol.

Registration

contextpilot install merges the MCP server into ~/.claude/mcp_servers.json for Claude Code. The command points Claude at the built @contextpilot/mcp server.

~/.claude/mcp_servers.jsonjson
{
  "mcpServers": {
    "contextpilot": {
      "command": "node",
      "args": ["/absolute/path/to/packages/mcp/dist/server.js"]
    }
  }
}

contextpilot_search

Search compact local memories before rereading files.

query·stringrequired

Natural-language query.

limit·number

Max results. Default 8, cap 20.

contextpilot_get

Fetch one full memory by ID returned from contextpilot_search.

id·stringrequired

Memory ID.

contextpilot_remember

Create a manual local memory.

title·stringrequired

Short searchable title.

content·stringrequired

Memory content.

files·string[]

Optional related files.

contextpilot_status

Returns the worker overview and current estimated savings.

Troubleshooting

terminalbash
contextpilot doctor
contextpilot status
contextpilot search "test memory"

If Claude cannot see the tools, rerun contextpilot install, restart Claude Code, and check ~/.claude/mcp_servers.json.

← PreviousHooksHow ctxpilot listensNext →CLISupported beta commands