Connect MCP with Cursor

Prerequisites

Cursor installed
An Architect account with access to a workspace

Setup

Open Cursor MCP settings

Open Cursor and go to Settings → MCP.You can also press Cmd+Shift+P (Mac) or Ctrl+Shift+P (Windows/Linux) and search for “MCP: Settings”.

Add the Architect MCP server

Click “Add new MCP server” and enter:

Name: Architect
Type: sse
URL: https://mcp.tryarchitect.com/mcp

Alternatively, add it manually to your .cursor/mcp.json file:

{
  "mcpServers": {
    "architect": {
      "url": "https://mcp.tryarchitect.com/mcp"
    }
  }
}

Authenticate with Architect

When you first use an Architect tool in Cursor’s Agent mode, a browser window will open asking you to sign in to your Architect account. Grant the requested permissions and your session will be saved.

Start using Architect tools

In Cursor’s Agent mode (not regular chat), you can now ask it to interact with your Architect workspace:

“Use architect_docs to show me the available API endpoints”
“List my pages using the Architect API”
“Look up how to create a prospect, then create one for [email protected]”

MCP tools are only available in Agent mode (Cmd+I / Ctrl+I), not in regular chat.

Available tools

Once connected, Cursor has access to two Architect MCP tools:

Tool	Description
`architect_docs`	Read Architect MCP docs plus targeted Customer API reference slices before you make a request.
`architect_api`	Call Customer API endpoints for the authenticated tenant after you know the exact method, path, and payload.

The recommended workflow is: use architect_docs first to understand what’s available, then use architect_api to execute.

Troubleshooting

Tools don't appear in Cursor

MCP tools only work in Agent mode. Make sure you’re using Cmd+I / Ctrl+I, not regular chat. Also verify the MCP server shows a green status indicator in Settings → MCP.

Server shows as disconnected

Check that the URL is exactly https://mcp.tryarchitect.com/mcp. Try removing the server and re-adding it. If it still fails, restart Cursor.

Authentication window doesn't appear

Make sure your browser isn’t blocking pop-ups from Cursor. Try opening https://mcp.tryarchitect.com/mcp directly in your browser to verify the server is reachable.

Overview

Setting up your account

Creating first pages

For inbound

For outbound

Integrations

Advanced

FAQ

Webhooks

Connect MCP with Cursor

Prerequisites

Setup

Available tools

Troubleshooting

​Prerequisites

​Setup

​Available tools

​Troubleshooting

Prerequisites

Setup

Available tools

Troubleshooting