Skip to main content
API Preview
Developers

Cursor & Cline

Both editors connect to a remote MCP server by URL. Add ~alter to the editor's MCP config and its identity tools appear in the agent. Anonymous tools work with no account; connect via OAuth to reach the authenticated tools.

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)
ConfigCursor: .cursor/mcp.json · Cline: cline_mcp_settings.json

Setup

1Cursor

Add ~alter to .cursor/mcp.json in the project, or ~/.cursor/mcp.json globally. Cursor infers Streamable HTTP from the url, so no transport field is needed.

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

2Cline

Add the same server to cline_mcp_settings.json. Cline accepts a remote server by url with headers.

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

Verify

Open the MCP panel in either editor. ~alter should show as connected with its tool list.

Notes

  • -Neither client needs a transport or type field; both infer Streamable HTTP from the url. Drop the headers block for anonymous access.
  • -Keep the server name tilde-free. The name here is alter (no wave); the client turns it into the tool prefix, and a tilde is not a legal character there, so the tools would show but never run. Use letters, numbers, hyphens or underscores only.
  • -No account tier is required. MCP works on every Cursor plan, including the free plan, and Cursor adds the server from local config.
  • -Cursor supports ${env:VAR} interpolation in the header value if you would rather not hard-code the capability token.
  • -If Cline shows the server using the older SSE transport after adding, re-check that it negotiated Streamable HTTP.