Skip to main content

​
Prerequisites

  • Cursor installed
  • An Architect account with access to a workspace

​
Setup

1

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”.
2

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"
    }
  }
}
3

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.
4

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 jane@acme.com”
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:
ToolDescription
architect_docsRead Architect MCP docs plus targeted Customer API reference slices before you make a request.
architect_apiCall 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

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.
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.
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.