Skip to main content
API Preview
Developers

Any MCP client

~alter speaks standard MCP over Streamable HTTP, so any MCP-capable client connects the same way. The generic config below works for any client; stdio-only clients bridge through mcp-remote, and the JSON-RPC endpoint is callable directly with no library. The verified clients below all connect this way. The app clients (Claude, ChatGPT, Le Chat, Perplexity) and developer tools (Claude Code, Codex, Cursor, Cline) each have their own page with tailored steps.

Connection

Endpointhttps://mcp.truealter.com/api/v1/mcp
TransportStreamable HTTP (JSON-RPC 2.0 over POST)
Auth headerAuthorization: Bearer <capability_token> (omit for anonymous tools)

Setup

1Point your client at the endpoint

If your client supports a remote Streamable-HTTP server, give it the URL and, for the authenticated tools, the OAuth-bearer capability token in the auth header.

json
{
  "mcpServers": {
    "alter": {
      "url": "https://mcp.truealter.com/api/v1/mcp",
      "headers": { "Authorization": "Bearer <capability_token>" }
    }
  }
}

2Stdio-only client? Bridge with mcp-remote

Clients that only speak stdio can reach the HTTP endpoint through the mcp-remote bridge.

bash
npx -y mcp-remote https://mcp.truealter.com/api/v1/mcp \
  --header "Authorization:Bearer <capability_token>"

3Or call it directly over JSON-RPC

Initialise the session, then discover tools. No library needed.

json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "initialize",
  "params": {
    "protocolVersion": "2025-11-25",
    "capabilities": {},
    "clientInfo": { "name": "my-agent", "version": "1.0.0" }
  }
}

Verify

After initialising, call tools/list to see every tool with its input schema and pricing.

json
{ "jsonrpc": "2.0", "id": 2, "method": "tools/list", "params": {} }

Notes

  • -mcp-remote needs the header as a single key:value token with no space after the colon.
  • -Anonymous tools work with no header. The authenticated tools settle per call over x402.

Verified clients

These clients connect to a custom remote MCP server using the generic config above. Each links to its own setup docs.

  • GitHub Copilot Works in IDE agent mode (VS Code, Visual Studio 17.14+, JetBrains, Xcode, Eclipse), not the GitHub.com web chat. Remote MCP works on all Copilot plans; on Copilot Business and Enterprise an org admin must first enable the "MCP servers in Copilot" policy, which is off by default.
  • Windsurf (Cascade) Config file (~/.codeium/mcp_config.json) or IDE settings; HTTP and SSE. Enterprise users enable it in settings, and admins can whitelist servers.
  • Zed settings.json context_servers; HTTP with OAuth.
  • Continue config.yaml mcpServers; SSE or streamable-http; agent mode.
  • Kimi Code CLI (Moonshot) CLI (kimi mcp add --transport http); HTTP and SSE.
  • Goose (Block) Remote streamable-HTTP via the CLI is the confirmed path; the desktop app modal may also work.
  • Gemini CLI (Google) settings.json mcpServers; httpUrl for streamable HTTP, url for SSE, with optional auth headers.
  • Amazon Q Developer CLI (AWS) Agent config (~/.aws/amazonq/cli-agents) mcpServers with type http; remote HTTP with OAuth.
  • JetBrains AI Assistant mcpServers JSON with a url; the base URL uses streamable HTTP, a /sse URL selects SSE.
  • Roo Code mcp_settings.json or .roo/mcp.json with type streamable-http or sse, url, and optional headers.
  • LibreChat librechat.yaml mcpServers with type streamable-http or sse and a url; streamable HTTP recommended for production.
  • Amp (Sourcegraph) amp.mcpServers with url and headers, or `amp mcp add <url>`; remote HTTP and SSE.
  • Qodo Gen Agentic Tools takes a remote SSE MCP via a url with optional custom HTTP headers.
  • fast-agent fastagent.config.yaml mcp.servers with transport http or sse, url, and headers.
  • OpenCLAW CLI assistant; config file (openclaw.json) or `openclaw onboard`.