Your agent connects to Typestate here
This is the address of the Typestate MCP server. Your agent builds your backend through it: record types, actions, web endpoints, and each release to Sandbox and Live. There is nothing to use on this page. You see what your agent did in the cockpit at platform.typestate.com.
https://mcp.typestate.com/mcp
The first time your agent connects, your browser opens a Typestate page. You sign in and allow the agent. There is no key to copy.
Connect your agent
Claude Code
Run this once, in the directory you work in.
claude mcp add --transport http typestate https://mcp.typestate.com/mcp
Then type /mcp in Claude Code, choose typestate and sign in.
Claude Desktop and claude.ai
Open Settings, then Connectors, and choose Add custom connector. Give it the name Typestate and the server address above, then choose Connect and sign in.
Cursor
Put this in ~/.cursor/mcp.json
for every project, or in .cursor/mcp.json
for one. Cursor then asks you to sign in.
{
"mcpServers": {
"typestate": {
"url": "https://mcp.typestate.com/mcp"
}
}
}
Codex
Run these once. The first adds the server, and the second opens your browser to sign in.
codex mcp add typestate --url https://mcp.typestate.com/mcp
codex mcp login typestate
Or put these lines in ~/.codex/config.toml, then run the sign-in above.
[mcp_servers.typestate]
url = "https://mcp.typestate.com/mcp"
The Codex command line, the IDE extension and the ChatGPT desktop app all read that file, so all three have Typestate after this.
To add it from the IDE extension instead, open the gear menu, choose MCP servers, then Add server. Choose Streamable HTTP, give it the server address above, and choose Authenticate when the list asks you to sign in.
ChatGPT
This needs ChatGPT on the web and a paid plan. In a Business or Enterprise workspace, an admin may have to allow custom servers first.
Open Plugins at chatgpt.com/plugins, choose the plus button,
then Add custom MCP server. Give it the name Typestate and the server address
above, choose OAuth, and confirm the warning. Choose Create as a plugin,
install it, and sign in. In a chat, type @
and choose Typestate. ChatGPT asks you to confirm each action that
changes something.
OpenAI's guide to custom MCP servers shows where these menus are today.
Other MCP clients
Add the server address above as a remote server over Streamable HTTP. The client asks you to sign in the first time it connects.
A script or an automated build
A script has nobody to sign in, so it sends an API key in a header. Make the key in the cockpit, under API key at the foot of Home or of the Connect your agent page of a backend.
Authorization: Bearer YOUR_KEY
Open an account
Open an account at typestate.com/start. Choose a plan, give your email address and tell us what you are building. We will contact you.
For agents
Read the typestate://guide resource before you build the first
backend. It says what the platform is for and how to write a definition
that builds well. The build_backend prompt turns a product
description into the whole workflow.