Connecting an MCP client¶

The IO Aerospace MCP Server speaks streamable-HTTP at https://mcp.io-aerospace.org/mcp. Any compliant MCP client can connect. This page covers three common ones.

Claude Desktop¶

Add the server to claude_desktop_config.json:

{
  "mcpServers": {
    "astrodynamics": {
      "transport": {
        "type": "http",
        "url": "https://mcp.io-aerospace.org/mcp"
      }
    }
  }
}

Restart Claude Desktop. The first time it queries the server, your browser opens for WorkOS sign-in (see Authentication). After that, the tool catalog appears in the model's tool picker.

Claude.ai (web)¶

Configure the connector in Claude.ai's settings, pointing at the same URL: https://mcp.io-aerospace.org/mcp. The MCP authorization spec discovery flow runs automatically.

Use the full /mcp URL

Always include the /mcp path. A bare-origin URL (https://mcp.io-aerospace.org) leaves the trailing slash ambiguous and breaks the discovery flow with McpAuthorizationError.

MCP Inspector¶

MCP Inspector is the easiest way to poke at the tool catalog without an LLM. Launch it, choose Streamable HTTP, paste the URL, and click through the OAuth flow. You can then list tools and call them with arbitrary JSON arguments.

TypeScript SDK¶

import { Client } from "@modelcontextprotocol/sdk/client/index.js";
import { HttpClientTransport } from "@modelcontextprotocol/sdk/client/transport/http.js";

const transport = new HttpClientTransport(new URL("https://mcp.io-aerospace.org/mcp"));
const client = new Client(
  { name: "astrodynamics-demo", version: "1.0.0" },
  { capabilities: { tools: {} } },
  transport
);

await client.connect();
const tools = await client.listTools();
console.log(tools.tools.map(t => t.name));

const utc = await client.callTool({ name: "CurrentDateTime", arguments: {} });
console.log(utc);

The SDK handles the OAuth flow automatically when it sees the WWW-Authenticate header.

Python SDK¶

The official Python SDK exposes an equivalent Client and HTTP transport. The same URL and OAuth flow apply.

Cursor and other clients¶

Any MCP client with streamable-HTTP support will work. Look in your client's settings for "MCP servers" or "Connectors", choose the HTTP transport, and paste https://mcp.io-aerospace.org/mcp. See Guides → MCP client integration for a longer list.