Skip to main content
Add Surfer to your Cursor MCP configuration, then sign in from the Cursor CLI or IDE.

Before you start

You need your own Surfer account on a plan that includes MCP. Sign in to your Cursor account in the CLI or the IDE.

Connect Surfer

Choose the client you use. The CLI and the IDE read the same configuration file.
1

Add the server

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

Sign in to Surfer

Start sign-in from your terminal:
  1. Sign in with your Surfer account in the browser window that opens.
  2. Check the account next to Signed in as. If it is the wrong one, select Switch account and sign in with the right one.
  3. Choose the organization to connect, if you belong to more than one.
  4. Select Authorize, then return to your client.
To change the account of a connection you already made, see Disconnect or switch accounts.

Verify the connection

In the CLI, run agent mcp list. In the IDE, the surfer entry under Customize → MCPs shows that it is connected and its tools are available. Ask your assistant: Your assistant lists the workspaces you belong to in the organization you authorized. Each workspace has a name, type, location, and state. Choose an active workspace for content tasks. A list shorter than the one in the app is expected: over MCP, workspaces you are not a member of are not listed and cannot be reached. If the list is empty, ask an organization owner or admin to add you to a workspace. Continue with Skills for guided workflows or Use cases for example requests. If the request fails, see Troubleshooting.