Darwin
OAuth

Darwin MCP

Use your Darwin agent from Claude, ChatGPT, Cursor, and any compatible MCP client. The canonical server URL is https://mcp.darwin.so/mcp.

Open MCP Server

Remote MCP server

MCP

Darwin OAuth

OAuth

Darwin API

API

Web app

Shared

iOS app

Shared
01

Shared Agent

One Darwin conversation across every client.

MCP clients reach the same user-scoped Darwin agent used by the web app, iOS app, and messaging channels.

What did we discuss last time, and what should I do next?
Get Darwin conversation

Request

{
  "days": 7,
  "query": "What did we discuss last time, and what …"
}

Response

{
  "status": "ok",
  "text": "I found the recent context from your Darwin c…"
}
Done
Message Darwin

Request

{
  "days": 7,
  "query": "What did we discuss last time, and what …"
}

Response

{
  "status": "ok",
  "text": "I found the recent context from your Darwin c…"
}
Done

I found the recent context from your Darwin conversation and continued from there. Your next best step is ready.

02

Darwin OAuth

No API key in the URL.

The MCP server starts the Darwin OAuth flow, verifies the signed user token, and forwards only the authenticated principal to Darwin API.

Connect Darwin to this client and show my recent conversation.
Authorize Darwin

Request

{
  "days": 7,
  "query": "Connect Darwin to this client and show m…"
}

Response

{
  "status": "ok",
  "text": "Connected with Darwin OAuth. I can now read a…"
}
Done
Get Darwin conversation

Request

{
  "days": 7,
  "query": "Connect Darwin to this client and show m…"
}

Response

{
  "status": "ok",
  "text": "Connected with Darwin OAuth. I can now read a…"
}
Done

Connected with Darwin OAuth. I can now read and continue your shared Darwin agent conversation.

03

API Boundary

MCP transport outside, product logic inside API.

The MCP gateway owns protocol transport only. Conversation state, identity, agent runtime calls, and product data remain behind Darwin API.

Send this request to my Darwin agent and keep it in my shared conversation.
Message Darwin

Request

{
  "days": 7,
  "query": "Send this request to my Darwin agent and…"
}

Response

{
  "status": "ok",
  "text": "The request was saved to your Darwin conversa…"
}
Done
Darwin API

Request

{
  "days": 7,
  "query": "Send this request to my Darwin agent and…"
}

Response

{
  "status": "ok",
  "text": "The request was saved to your Darwin conversa…"
}
Done

The request was saved to your Darwin conversation and completed through the same agent runtime used by Darwin clients.

04

Canonical URL

Use mcp.darwin.so for MCP transport.

The public web page can explain MCP, but MCP-compatible clients should connect to the transport endpoint at https://mcp.darwin.so/mcp.

Add Darwin as a remote HTTP MCP server.
Server URL

Request

{
  "days": 7,
  "query": "Add Darwin as a remote HTTP MCP server.…"
}

Response

{
  "status": "ok",
  "text": "Use https://mcp.darwin.so/mcp. Darwin OAuth h…"
}
Done
Darwin OAuth

Request

{
  "days": 7,
  "query": "Add Darwin as a remote HTTP MCP server.…"
}

Response

{
  "status": "ok",
  "text": "Use https://mcp.darwin.so/mcp. Darwin OAuth h…"
}
Done

Use https://mcp.darwin.so/mcp. Darwin OAuth handles authentication when your client connects.

Get started in 3 minutes

Three steps to connect your AI client to your Darwin agent.

1

Sign in with Darwin

Darwin MCP uses OAuth. Sign in with the same Darwin account you use on the web or mobile app; no API key belongs in the MCP URL.

Sign in to Darwin
2

Add the MCP to your AI client

Open Claude's connector settings and paste these two fields. Claude will send you through Darwin OAuth the first time it connects.

NameDarwin
Server URLhttps://mcp.darwin.so/mcp
Add Connector to Claude
3

All set — try it out

Start with a read-only prompt to confirm the connector can see your shared Darwin conversation.

Try thisShow me the recent messages in my Darwin conversation.

Tools

The current Darwin MCP gateway exposes these tools, then forwards authenticated requests to Darwin API.

Agentmessage_darwin

Send a message to the authenticated user's Darwin agent.

get_darwin_conversation

Read recent messages from the authenticated user's shared Darwin agent conversation.