MCP

Use your Darwin agent from any client that supports remote Model Context Protocol servers. Every client connects to the same Darwin account, agent context, and conversation.

Server URL

https://mcp.darwin.so/mcp

Darwin MCP uses browser-based OAuth. Do not append an API key or another query parameter to the URL.

Connect a client

ChatGPT
Claude
Cursor
Codex
Other clients

ChatGPT custom MCP apps require Developer Mode and availability depends on your plan and workspace settings.

Open Settings → Apps → Advanced settings and enable Developer Mode.
Choose Create app or Add custom app.
Name the app Darwin and enter https://mcp.darwin.so/mcp as the MCP server URL.
Create the app, choose Connect, and complete Darwin OAuth in the browser.
Start a new conversation and enable Darwin from the app or tools menu.

Business, Enterprise, and Education workspaces may require an administrator to enable Developer Mode or approve the app. ChatGPT snapshots an app’s tools when it is created; refresh the app after Darwin adds or changes tools.See OpenAI’s Developer Mode guide for current plan and administrator requirements.

Open Customize → Connectors in Claude.
Choose Add custom connector.
Name it Darwin and paste https://mcp.darwin.so/mcp.
Add the connector, choose Connect, and complete Darwin OAuth.
Enable Darwin in a conversation and ask Claude to read or message your agent.

On Team and Enterprise plans, an owner may first need to add Darwin from Organization settings → Connectors → Add → Custom. Members can then connect it from their personal connector settings.See Claude’s custom connector guide for the latest workspace flow.

Add Darwin from Cursor’s MCP settings, or create .cursor/mcp.json in a project:

{
  "mcpServers": {
    "darwin": {
      "url": "https://mcp.darwin.so/mcp"
    }
  }
}

Use ~/.cursor/mcp.json instead to make Darwin available in every project. Return to Cursor, enable the server, and complete the OAuth prompt.See Cursor’s MCP documentation for global configuration and server controls.

Add the remote server from the Codex CLI:

codex mcp add darwin --url https://mcp.darwin.so/mcp

Complete the browser sign-in when Codex requests authorization. The same server is then available to Codex sessions using your MCP configuration.

Clients that accept standard MCP JSON commonly use:

{
  "mcpServers": {
    "darwin": {
      "url": "https://mcp.darwin.so/mcp"
    }
  }
}

Choose the client’s Connect or Authorize action and complete Darwin OAuth. The client must support remote Streamable HTTP MCP servers and OAuth.

Available tools

Tool	Scope	Behavior
`get_darwin_conversation`	`agent:read`	Reads recent messages from your shared Darwin conversation.
`message_darwin`	`agent:write`	Sends a message to your Darwin agent and returns its response.

The MCP server never accepts a user ID or provider credential from the model. Darwin resolves the authenticated owner and enforces scopes on every request.

Verify the connection

Try a read before a write:

Show me the recent messages in my Darwin conversation.

Your client should call get_darwin_conversation. Then try:

Ask Darwin to summarize my active priorities.

Your client should call message_darwin.

OAuth permissions

Darwin requests only the permissions required by its MCP tools:

agent:read to read the shared conversation
agent:write to send a message
openid, profile, and email to identify the signed-in Darwin account
offline_access when the client supports refresh tokens

You can revoke the connection from Darwin or remove it from the MCP client.

Troubleshooting

The client returns 401 Unauthorized

The connection is missing, expired, or was revoked. Remove Darwin from the client, add the canonical URL again, and complete OAuth.

Darwin reports a missing scope

Reconnect and approve the requested agent:read or agent:write permission. Darwin does not silently broaden an existing grant.

The tools are missing or stale

Refresh or reconnect the server. ChatGPT workspace administrators may need to review an updated tool snapshot.

The browser opens the wrong Darwin account

Sign out of Darwin in that browser or use a private window, then restart authorization from the MCP client.

Start

Surfaces

Agent

External applications

Resources

Server URL

Connect a client

Available tools

Verify the connection

OAuth permissions

Troubleshooting

​Server URL

​Connect a client

​Available tools

​Verify the connection

​OAuth permissions

​Troubleshooting

Server URL

Connect a client

Available tools

Verify the connection

OAuth permissions

Troubleshooting