Skip to content

MCP for AI agents

MCP is gatOS’s agent interface. It exposes the same snapshots and command queue as the other transports, but groups them into logical resources and tools such as world, celestial, vessel, kitten, runtime, controls, batches, schedules, camera, audio, FX, and paint.

The default local endpoint is:

http://127.0.0.1:4243/mcp

It is Streamable HTTP and binds to loopback by default. Set mcp_bind_host to another IP or 0.0.0.0 for all IPv4 interfaces. There is no guest endpoint, bearer token, CORS policy, or legacy SSE transport in MCP v1, so a non-loopback bind exposes the endpoint to reachable clients. Start with gatos.get_capabilities, then discover vessels and read a fresh snapshot before sending a narrow command.

MCP is deliberately not a path-for-path /sim copy. It uses raw KSA IDs, structured JSON, and logical actions. /sim/display is intentionally outside MCP v1 because a terminal image stream is a poor substitute for an agent-readable world model.

Continue with Connect and get started or browse the MCP documentation.