Skip to main content
Add Surfer to your Cursor MCP configuration, then sign in from the server list.

​
Before you start

You need your own Surfer account on a plan that includes MCP. Open Cursor and sign in to your Cursor account.

​
Connect Surfer

1

Add the server configuration

Add this entry to ~/.cursor/mcp.json to make Surfer available across projects. For one project, use .cursor/mcp.json in that project instead:
If the file already contains servers, add surfer inside the existing mcpServers object.
2

Open Surfer in Cursor

Open Customize → MCPs. Find surfer, enable it, and select Authenticate if Cursor asks you to sign in.
3

Authorize Surfer

  1. Sign in with your Surfer account in the browser window that opens.
  2. Choose the organization to connect, if you belong to more than one.
  3. Select Authorize, then return to your client.
If the browser signs you in to the wrong Surfer account, follow Disconnect or switch accounts.
4

Open an agent chat

Start a new agent chat with the Surfer server enabled. Cursor asks for approval before using an MCP tool by default.
The Cursor CLI uses the same MCP configuration. After adding the server, sign in from your terminal:
Then run agent mcp list to check the connection.

​
Verify the connection

The surfer entry under Customize → MCPs should show that it is connected and its tools are available. Ask your assistant: Your assistant lists the workspaces in the organization you authorized. Each workspace has a name, type, location, and state. Choose an active workspace for content tasks. Continue with Skills for guided workflows or Use cases for example requests. If the request fails, see Troubleshooting.