# Set up DoDomain in Cursor: MCP and SDK

> Connect Cursor to DoDomain's remote MCP server with OAuth, install the SDK and verify it, or paste one sentence and let it do the work.

- Canonical HTML page: https://dodomain.io/agent-setup/cursor
- This Markdown twin: https://dodomain.io/agent-setup/cursor.md
- Site index for agents: https://dodomain.io/llms.txt
- Full documentation as Markdown: https://dodomain.io/docs/llms-full.txt

Generated at build time from the same React source the HTML page renders, never a hand-maintained second copy. Every public page on this host has a twin at `<url>.md`.

---

[Agent setup](https://dodomain.io/agent-setup)

## Set up DoDomain in Cursor

The fast way: copy this sentence into Cursor and let it do the setup below itself.

[Add DoDomain to Claude](https://claude.ai/directory/a7fc39a1-9ea8-48f0-9d66-2ac84f2508d1): one click opens DoDomain's listing in Claude's connector directory.

Onboard your agent to DoDomain: paste this sentence into any AI coding agent.

```
Fetch and execute the appropriate instructions to set me up for DoDomain from https://dodomain.io/agent-setup/prompt.md
```

### Connect the MCP server

1. 1. Add the server to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (this project only). If the file exists, merge the dodomain entry into its mcpServers object.
   
   File: `~/.cursor/mcp.json`
   
   ```
   { "mcpServers": { "dodomain": { "url": "https://app.dodomain.io/api/mcp" } } }
   ```

**Sign in.** Cursor discovers the OAuth endpoints from the URL. When dodomain shows as needing login in Cursor Settings under MCP, click it to open the DoDomain sign-in and consent page. No API key is involved: the MCP server uses OAuth and refuses secret keys by design.

### What you get

- **The DoDomain MCP server** at `https://app.dodomain.io/api/mcp`, with OAuth sign-in and 68 tools that cover every dashboard action.
- **The SDK for your stack**: @dodomain/node, dodomain-sdk, @dodomain/connect, @dodomain/react, with the secret key read from `DODOMAIN_SECRET_KEY`.
- **A verified setup**: the agent calls `list_apps` and the REST API before it reports back.

### Install the SDK

Server code uses a secret key from `DODOMAIN_SECRET_KEY`. Create an app at [https://app.dodomain.io/dashboard](https://app.dodomain.io/dashboard) and copy the secret key from its API keys card. It is shown once.

- @dodomain/node (Node.js 20+ server)
  
  Create connect sessions, manage connections, verify signed webhooks.
  
  ```
  npm install @dodomain/node
  ```
- dodomain-sdk (Python 3.10+ server)
  
  The same server surface as @dodomain/node, sync and async.
  
  ```
  pip install dodomain-sdk
  ```
- @dodomain/connect (Browser)
  
  Opens the hosted connect flow as a sheet inside your own UI, driven by a session token your server minted.
  
  ```
  npm install @dodomain/connect
  ```
- @dodomain/react (React)
  
  The widget as a useDoDomainConnect hook.
  
  ```
  npm install @dodomain/react
  ```

### Verify

After signing in, ask the agent to call the `list_apps` tool: it lists the apps on your team. To check a secret key, run:

```
curl -s https://app.dodomain.io/api/v1/apps -H "Authorization: Bearer $DODOMAIN_SECRET_KEY"
```

Success is HTTP 200 with a JSON body of the form {"apps": [...]}: a secret key sees exactly its own app, with its id, name and publishable key.

### Start on the free plan

No card, no sales call: create an app, mint a session, and watch the first domain verify.

[Start with 50 free](https://app.dodomain.io/signin?mode=signup) [Read the quickstart](https://dodomain.io/docs)

Cursor's own MCP documentation: [https://cursor.com/docs/context/mcp](https://cursor.com/docs/context/mcp). Other agents: [all agent guides](https://dodomain.io/agent-setup).
