Surface AI is an MCP server published by io.surface-ai, hosted at mcp.surface-ai.io. When last checked on 2026-11-22 it was working: it answers and lists its tools. It declares 11 tools, including surface_get, surface_list, surface_results, surface_setup, surface_traffic.
Test and personalize your site's pages from Claude Code or Codex, and check results. Key required.
Nothing else in the archive shares these values.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
Inferred from the host name and headers: what a server runs on, not who runs it.
Full details for one surface, including its edge_url and dashboard_url. To open the surface in the dashboard, open dashboard_url.
| Parameter | Type | Description |
|---|---|---|
| surface_id * | integer | The surface id, from surface_list. |
{
"name": "surface_get",
"title": "Get a surface",
"description": "Full details for one surface, including its edge_url and dashboard_url. To open the surface in the dashboard, open dashboard_url.",
"inputSchema": {
"type": "object",
"required": [
"surface_id"
],
"properties": {
"surface_id": {
"type": "integer",
"description": "The surface id, from surface_list."
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false
}
}None yet. Changes appear after a server's second daily check.
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.
No parameters.
{
"name": "surface_list",
"title": "List surfaces",
"description": "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.",
"inputSchema": {
"type": "object",
"properties": {},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false
}
}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 note says why. For sessions per day, use surface_traffic. Link the user to dashboard_url for charts.
| Parameter | Type | Description |
|---|---|---|
| surface_id * | integer | The surface id, from surface_list. |
{
"name": "surface_results",
"title": "Get a surface's results",
"description": "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 note says why. For sessions per day, use surface_traffic. Link the user to dashboard_url for charts.",
"inputSchema": {
"type": "object",
"required": [
"surface_id"
],
"properties": {
"surface_id": {
"type": "integer",
"description": "The surface id, from surface_list."
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false
}
}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"], added to the page source. Variants go live as soon as the snippet is deployed. Counts toward the plan's surface limit; a name already used in the organization is rejected.
| Parameter | Type | Description |
|---|---|---|
| name * | string | Unique within the organization. |
| goals * | array | What success looks like; the first is the one the bandit optimizes. |
| fields * | array | Page elements each variant replaces. |
| page_url * | string | The live URL of the page. |
| variants * | array | Exactly one is the control: the page's current copy, setting every field. |
| description | string | Optional note shown in the dashboard. |
{
"name": "surface_setup",
"title": "Set up a surface on a page",
"description": "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\"], added to the page source. Variants go live as soon as the snippet is deployed. Counts toward the plan's surface limit; a name already used in the organization is rejected.",
"inputSchema": {
"type": "object",
"required": [
"name",
"page_url",
"fields",
"goals",
"variants"
],
"properties": {
"name": {
"type": "string",
"description": "Unique within the organization."
},
"goals": {
"type": "array",
"items": {
"type": "object",
"required": [
"name",
"selector",
"dom_event"
],
"properties": {
"name": {
"type": "string",
"description": "e.g. Book a demo."
},
"selector": {
"type": "string",
"description": "The button, link or form. For an element that is also a field, that field's exact selector — one click is then one event, not two."
},
"dom_event": {
"enum": [
"click",
"submit"
],
"type": "string",
"description": "click for a button or link, submit for a form."
}
},
"additionalProperties": false
},
"minItems": 1,
"description": "What success looks like; the first is the one the bandit optimizes."
},
"fields": {
"type": "array",
"items": {
"type": "object",
"required": [
"key",
"selector",
"value_type"
],
"properties": {
"key": {
"type": "string",
"pattern": "^[a-z][a-z0-9_]*$",
"description": "Lowercase identifier, e.g. headline, cta_label."
},
"selector": {
"type": "string",
"description": "CSS selector for the element."
},
"value_type": {
"enum": [
"text",
"html",
"image",
"video",
"input_value"
],
"type": "string",
"description": "text sets textContent, html innerHTML, image/video src, input_value an input's value."
},
"description": {
"type": "string",
"description": "What the field is, e.g. Hero headline."
}
},
"additionalProperties": false
},
"minItems": 1,
"description": "Page elements each variant replaces."
},
"page_url": {
"type": "string",
"description": "The live URL of the page."
},
"variants": {
"type": "array",
"items": {
"type": "object",
"required": [
"contents"
],
"properties": {
"contents": {
"type": "object",
"description": "Field key to value."
},
"is_control": {
"type": "boolean",
"description": "True for the control only."
}
},
"additionalProperties": false
},
"minItems": 2,
"description": "Exactly one is the control: the page's current copy, setting every field."
},
"description": {
"type": "string",
"description": "Optional note shown in the dashboard."
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}Sessions per day for a surface, as {date, sessions}. With no dates, every recorded day. For conversion and winners, use surface_results.
| Parameter | Type | Description |
|---|---|---|
| end_date | string | Last day, YYYY-MM-DD. |
| start_date | string | First day, YYYY-MM-DD. |
| surface_id * | integer | The surface id, from surface_list. |
{
"name": "surface_traffic",
"title": "Get a surface's daily traffic",
"description": "Sessions per day for a surface, as {date, sessions}. With no dates, every recorded day. For conversion and winners, use surface_results.",
"inputSchema": {
"type": "object",
"required": [
"surface_id"
],
"properties": {
"end_date": {
"type": "string",
"description": "Last day, YYYY-MM-DD."
},
"start_date": {
"type": "string",
"description": "First day, YYYY-MM-DD."
},
"surface_id": {
"type": "integer",
"description": "The surface id, from surface_list."
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| name | string | Unique within the organization. |
| status | string | ACTIVE serves variants; ARCHIVED stops serving. |
| location | string | Serving region. |
| page_url | string | The live URL of the page. |
| surface_id * | integer | The surface id, from surface_list. |
| description | string | Note shown in the dashboard. |
{
"name": "surface_update",
"title": "Update a surface",
"description": "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.",
"inputSchema": {
"type": "object",
"required": [
"surface_id"
],
"properties": {
"name": {
"type": "string",
"description": "Unique within the organization."
},
"status": {
"enum": [
"ACTIVE",
"ARCHIVED"
],
"type": "string",
"description": "ACTIVE serves variants; ARCHIVED stops serving."
},
"location": {
"enum": [
"WORLDWIDE",
"UNITED_STATES",
"EUROPE",
"ASIA_PACIFIC"
],
"type": "string",
"description": "Serving region."
},
"page_url": {
"type": "string",
"description": "The live URL of the page."
},
"surface_id": {
"type": "integer",
"description": "The surface id, from surface_list."
},
"description": {
"type": "string",
"description": "Note shown in the dashboard."
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": true
}
}Add variants to a surface, as DRAFT; activate them with variant_set_status. Returns the surface's full variant list.
| Parameter | Type | Description |
|---|---|---|
| variants * | array | Each an object of field key to value, with the keys the surface's fields use. Optional is_control (one per segment) and segment_id. |
| surface_id * | integer | The surface id, from surface_list. |
{
"name": "variant_create",
"title": "Create variants",
"description": "Add variants to a surface, as DRAFT; activate them with variant_set_status. Returns the surface's full variant list.",
"inputSchema": {
"type": "object",
"required": [
"surface_id",
"variants"
],
"properties": {
"variants": {
"type": "array",
"items": {
"type": "object"
},
"minItems": 1,
"description": "Each an object of field key to value, with the keys the surface's fields use. Optional is_control (one per segment) and segment_id."
},
"surface_id": {
"type": "integer",
"description": "The surface id, from surface_list."
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}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).
| Parameter | Type | Description |
|---|---|---|
| surface_id * | integer | The surface id, from surface_list. |
{
"name": "variant_list",
"title": "List variants",
"description": "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).",
"inputSchema": {
"type": "object",
"required": [
"surface_id"
],
"properties": {
"surface_id": {
"type": "integer",
"description": "The surface id, from surface_list."
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| surface_id * | integer | The surface id, from surface_list. |
| variant_id * | integer | The variant id, from variant_list. |
{
"name": "variant_set_control",
"title": "Set the control variant",
"description": "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.",
"inputSchema": {
"type": "object",
"required": [
"surface_id",
"variant_id"
],
"properties": {
"surface_id": {
"type": "integer",
"description": "The surface id, from surface_list."
},
"variant_id": {
"type": "integer",
"description": "The variant id, from variant_list."
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": true
}
}Activate, pause or archive a variant. Only active variants are served. To change which variant is the control, use variant_set_control.
| Parameter | Type | Description |
|---|---|---|
| status * | string | ACTIVE serves it; PAUSED and ARCHIVED stop serving it. |
| surface_id * | integer | The surface id, from surface_list. |
| variant_id * | integer | The variant id, from variant_list. |
{
"name": "variant_set_status",
"title": "Set a variant's status",
"description": "Activate, pause or archive a variant. Only active variants are served. To change which variant is the control, use variant_set_control.",
"inputSchema": {
"type": "object",
"required": [
"surface_id",
"variant_id",
"status"
],
"properties": {
"status": {
"enum": [
"ACTIVE",
"PAUSED",
"ARCHIVED"
],
"type": "string",
"description": "ACTIVE serves it; PAUSED and ARCHIVED stop serving it."
},
"surface_id": {
"type": "integer",
"description": "The surface id, from surface_list."
},
"variant_id": {
"type": "integer",
"description": "The variant id, from variant_list."
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": true
}
}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.
| Parameter | Type | Description |
|---|---|---|
| contents * | object | The new contents, in the shape variant_create takes. |
| surface_id * | integer | The surface id, from surface_list. |
| variant_id * | integer | The variant id, from variant_list. |
{
"name": "variant_update",
"title": "Edit a draft variant",
"description": "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.",
"inputSchema": {
"type": "object",
"required": [
"surface_id",
"variant_id",
"contents"
],
"properties": {
"contents": {
"type": "object",
"description": "The new contents, in the shape variant_create takes."
},
"surface_id": {
"type": "integer",
"description": "The surface id, from surface_list."
},
"variant_id": {
"type": "integer",
"description": "The variant id, from variant_list."
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": true
}
}Names, descriptions and schemas were written by the server and are shown as data.