Connecting AI tools

Connect Claude Code, Cursor, Windsurf, or any MCP-compatible tool to your Galaxy.

Orion exposes 16 MCP tools at a single endpoint. Any tool that speaks MCP can connect.

Prerequisites

• Orion stack running (docker compose up -d)
• Health check passing: curl http://localhost:8000/health

Claude Code

claude mcp add orion --transport http http://localhost:8000/mcp

Cursor / Windsurf

Add to your MCP configuration file:

{
  "orion": {
    "url": "http://localhost:8000/mcp"
  }
}

Verify the connection

In a new conversation, ask the agent to orient:

"Call brain.orient with agent_name 'my-agent' and tell me what you see."

A successful response includes the agent's identity, galaxy context, and operating protocol. If the tool isn't available, check that the MCP endpoint is reachable at http://localhost:8000/mcp.

What's available

Namespace	Count	Purpose
memory.*	5	Knowledge storage and retrieval — works immediately, no setup
brain.*	8	Cognitive operations — orientation, thinking, recall, calibration, graph queries
sun.*	3	Steering document — read, update, working context

See the MCP Tools Reference for full parameter documentation and usage examples.

Troubleshooting

Tool not appearing in the AI tool's interface: Restart the AI tool after adding the MCP configuration. Some tools cache the tool list at startup.

Connection refused: Verify Orion is running with curl http://localhost:8000/health. If degraded lists services, those services may still be starting.

Timeout on first call: The first brain.orient after a cold start may take 1–2 seconds while caches warm. Subsequent calls return in under 30ms.