MCP Setup

Waypath ships an MCP (Model Context Protocol) server at https://mcp.waypath.app. Once registered, any MCP-aware agent (Claude Desktop, Cursor, custom Anthropic SDK loops) gets four tools: get_customer_context, get_account_brief, write_memory, ingest_event. Same surface as the REST API, but the agent calls them by name instead of by URL.

Claude Code / Cursor

claude mcp add --transport http waypath https://mcp.waypath.app -s user

That writes the registration to your user-scope MCP config. New Claude sessions pick it up automatically. You will be prompted for your wp_live_... key on first use.

Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "waypath": {
      "command": "npx",
      "args": ["-y", "@waypath/mcp"],
      "env": {
        "WAYPATH_API_KEY": "wp_live_..."
      }
    }
  }
}

Restart Claude Desktop. Test it by asking “what do you know about jane@acme.com” - the model should call get_customer_context unprompted.

ChatGPT / OpenAI / generic agent loops

OpenAI’s hosted apps do not yet speak MCP over HTTP. Use the REST API directly. Every MCP tool maps 1:1 to a REST endpoint:

See Customer Context, Account Brief, Memory Writes, Events for full contracts.

Tool reference

get_customer_context

{
  id?: string         // Customer ID
  email?: string      // OR resolve by email
  budget?: number     // Token budget. Default 2048.
}

Returns the CustomerContext shape.

get_account_brief

{
  id: string          // Account ID
}

Returns the AccountBrief shape.

write_memory

{
  customer: string
  type: 'decision' | 'action' | 'observation'
  agent: string
  payload: object
  idempotency_key?: string
}

Returns { id, customer, type, ts, idempotency_key? }.

ingest_event

{
  event: string
  customer?: string
  email?: string
  phone?: string
  externalId?: string
  properties?: object
  timestamp?: string  // ISO-8601
}

Returns { eventId, customerId, resolved }.

Auth

The MCP server reads WAYPATH_API_KEY from env. With Claude Code’s claude mcp add flow, the CLI prompts on first use and persists the key to its user-scope config. With Claude Desktop’s JSON config, you set env.WAYPATH_API_KEY directly.

The same key scopes apply. A key with only context:read will fail write_memory calls with forbidden_scope.

Troubleshooting

See also

• Quickstart
• API Keys
• CLI