Connect via MCP

Claude Code

# CLI (one-line)
claude mcp add --transport sse crosspay https://docs.crosspay.internal/mcp

# Verify
claude mcp list

After connecting, ask Claude something like “use crosspay search_docs to find idempotency docs” to verify the integration.

Cursor

Add an entry in your ~/.cursor/mcp.json:

// ~/.cursor/mcp.json
{
  "mcpServers": {
    "crosspay": {
      "url": "https://docs.crosspay.internal/mcp"
    }
  }
}

Codex

Add an entry in your ~/.codex/config.toml:

# ~/.codex/config.toml
[mcp_servers.crosspay]
url = "https://docs.crosspay.internal/mcp"

Smoke test

Confirm the endpoint is live and lists all six tools before wiring it into your IDE:

# Streamable HTTP — list every tool exposed by docs-mcp
curl -s -X POST https://docs.crosspay.internal/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' | jq

Run locally (stdio)

For desktop integrations or air-gapped development, run docs-mcp directly against your local clone:

# Run docs-mcp locally over stdio (for desktop integrations).
DOCS_MCP_CONTENT_ROOT=$PWD/content/docs \
DOCS_MCP_OPENAPI_PATH=$PWD/content/openapi/v1.yaml \
go run ./apps/docs-mcp/cmd/mcp --stdio

What gets exposed

• search_docs(query, k?) — ranked search across the Markdown corpus.
• get_page(path | url) — fetch a single page with frontmatter and full Markdown body.
• list_endpoints(tag?) — every API endpoint with operationId, method, path, summary, tags.
• get_endpoint(operationId) — full schema for one endpoint.
• get_openapi(version) — raw OpenAPI YAML.
• list_webhook_events() — webhook catalogue with payload examples.

Read-only over public content. No authentication; only per-IP rate limiting. For Try-it-out (which injects a sandbox API key), see the intro.