Skip to content
MCP server

Surface AI

MCP server that lets Claude Code or Codex set up and manage website personalization tests

Answered our latest tool-list check 5 hours ago with 11 tools. It will be marked verified after 3 successful checks in 7 days.

Install
Platforms
API, CLI
Runs
Remotely
Version
1.0.0
Listing updated
1 day ago

Similar MCP servers

About Surface AI

Surface AI is an MCP server for marketing and seo. It runs as a hosted remote server, so there is nothing to install locally.

Surface runs a different version of a page's content for each visitor and tracks which version moves visitors toward a chosen goal. Its MCP server lets Claude Code or Codex do the setup and upkeep from inside the codebase already open in the editor. The docs say the agent finds the target page in code, proposes elements to vary and goals to measure, and drafts variants with the user before anything is created.

Once a test is live, the agent can list and inspect surfaces, add or edit variants, activate or pause tests, and choose which control to show. It can also read per-variant sessions, goal conversions, conversion rate, the chance each variant is best, and daily traffic. A link to the dashboard is available for charts and full history.

The server is aimed at developers and marketers who already work with Claude Code or Codex. Access requires a Surface account and a management key from the Settings page, and the docs note that other MCP clients are not supported yet.

Install

Run in a terminal

claude mcp add --transport http surface https://mcp.surface-ai.io/mcp/

Add to Settings → Connectors → Add custom connector

https://mcp.surface-ai.io/mcp/
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "surface": {
      "url": "https://mcp.surface-ai.io/mcp/"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "surface": {
      "type": "http",
      "url": "https://mcp.surface-ai.io/mcp/"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "surface": {
      "serverUrl": "https://mcp.surface-ai.io/mcp/"
    }
  }
}

Add to Grok Bot desktop app → Connect apps → Add a custom connector

https://mcp.surface-ai.io/mcp/

Enter a Name (for example "Surface AI"), choose Type: Remote HTTPS, paste this as the Server URL and choose Add plugin.

Full Grok Bot setup guide

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "surface": {
      "type": "http",
      "url": "https://mcp.surface-ai.io/mcp/"
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Tools this server provides (11)

Read directly from the server.

5 of 11 tools say they're read-only. 6 of 11 tools say they can delete or change data.

From the server's own tool annotations; not verified by us.

surface_getSays read-only
Full details for one surface, including its edge_url and dashboard_url. To open the surface in the dashboard, open dashboard_url.
surface_listSays read-only
List every surface in the caller's organization, with each one's id, name, page URL, status and live_state. Use surface_get for one surface's dashboard link.
surface_resultsSays read-only
How a surface's test is doing: per variant, its sessions, sessions that reached the goal, conversion rate (rate_per_session) and win_probability — the bandit's estimated chance that variant is best. termination.should_terminate is the bandit's own signal that the test has a clear winner. Also all-time traffic per event. Results are recomputed hourly; before the first run, variants is empty and not
surface_setupSays it can change data
The way to add a surface to a page, in one step: the content fields it swaps, the goals it optimizes, and the variants — with the integration bundle deployed. Returns the install guide for adding the snippet to that page. Ask the user to choose the fields, goals and variants first; the new_surface prompt walks through it. Prefer data-attribute selectors such as [data-surface-field="headline"], add
surface_trafficSays read-only
Sessions per day for a surface, as {date, sessions}. With no dates, every recorded day. For conversion and winners, use surface_results.
surface_updateSays it can change data
Change a surface's name, description, status, page URL or location; fields you leave out are unchanged. Returns the updated surface. ARCHIVED stops it serving; making it ACTIVE again counts toward the plan's surface limit. To change content, use the variant_ tools; to add a surface, surface_setup.
variant_createSays it can change data
Add variants to a surface, as DRAFT; activate them with variant_set_status. Returns the surface's full variant list.
variant_listSays read-only
List every variant of a surface, the control included: each one's id, status, is_control and raw_contents (a JSON object of field key to value).
variant_set_controlSays it can change data
Make a variant the control of its segment — the baseline the others are measured against — replacing the current control. An archived variant can't be the control. Status is unchanged; use variant_set_status for that.
variant_set_statusSays it can change data
Activate, pause or archive a variant. Only active variants are served. To change which variant is the control, use variant_set_control.
variant_updateSays it can change data
Replace a draft variant's contents with the given object. Only drafts can be edited; to change a live variant, create a new one and archive the old.

What it does

Guided surface setup
Finds a page in the codebase, proposes elements and goals, and creates the test only after each step is approved.
Variant management
Lists and inspects surfaces, adds variants, edits drafts, and activates or pauses them.
Live results reading
Reports sessions, goal conversions, conversion rate, and each variant's chance of being best.
Traffic data
Returns daily traffic for each surface so trends can be checked alongside test results.
Dashboard handoff
Opens the matching surface in the Surface dashboard for charts and full history.

Good for

  • Setting up a personalized variant test on a pricing or landing page from the editor
  • Checking whether a running headline test has a clear winner
  • Adding new headline variants to an existing surface
  • Pausing underperforming variants and planning the next round of tests

Surface AI FAQ

Which AI clients does it support?

The docs say it works with a recent version of Claude Code or Codex, and that other MCP clients are not supported yet.

What do I need to connect?

A Surface account and a management key from Settings → Developers, sent as a bearer token to the endpoint.

Does the agent create anything without approval?

The docs state that nothing is created until each step has been approved.

How do I add Surface AI to Claude Code?

Run this command in your terminal: claude mcp add --transport http surface https://mcp.surface-ai.io/mcp/

What are the best alternatives to Surface AI?

The closest alternatives to Surface AI are Agentzia, WhyIQ CRO & AI Visibility Autopilot, Mida, Marketing Scope and Scaplet.

Where this comes from

  • Description: written from the project's website and its MCP Registry entry.
  • Status and tools: checked automatically by AIPoweredBot on 19 November 2026.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers