Surface AI
Test and personalize your site's pages from Claude Code or Codex, and check results. Key required.
Sollte ich dies verwenden
Qualität und Sicherheit
Basierend auf einer automatisierten Analyse der Tool-Definitionen und der Einhaltung des Protokolls.
Kontextkosten
Dies ist die ungefähre Anzahl der Tokens, die jedes Mal verbraucht werden, wenn die Tools des Servers in den Kontext eines Modells geladen werden. Höhere Werte verringern die Aufmerksamkeit, die für andere Aufgaben verfügbar ist.
Installieren
Installation mit einem Klick
Fügen Sie dies Ihrer Datei `claude_desktop_config.json` hinzu:
{
"mcpServers": {
"surface": {
"url": "https://mcp.surface-ai.io/mcp/"
}
}
}Remote-Endpunkte
https://mcp.surface-ai.io/mcp/streamable-httpWas es kann
Tool-Inventar
Tools (11)
🟢surface_get(surface_id)
Full details for one surface, including its edge_url and dashboard_url. To open the surface in the dashboard, open dashboard_url.
Eingabe-Schema
{
"type": "object",
"properties": {
"surface_id": {
"type": "integer",
"description": "The surface id, from surface_list."
}
},
"required": [
"surface_id"
],
"additionalProperties": false
}🟢surface_list
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.
Eingabe-Schema
{
"type": "object",
"properties": {},
"additionalProperties": false
}🟢surface_results(surface_id)
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.
Eingabe-Schema
{
"type": "object",
"properties": {
"surface_id": {
"type": "integer",
"description": "The surface id, from surface_list."
}
},
"required": [
"surface_id"
],
"additionalProperties": false
}🟡surface_setup(name, page_url, description, fields, goals, ...)
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.
Eingabe-Schema
{
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "Unique within the organization."
},
"page_url": {
"type": "string",
"description": "The live URL of the page."
},
"description": {
"type": "string",
"description": "Optional note shown in the dashboard."
},
"fields": {
"type": "array",
"minItems": 1,
"description": "Page elements each variant replaces.",
"items": {
"type": "object",
"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": {
"type": "string",
"enum": [
"text",
"html",
"image",
"video",
"input_value"
],
"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."
}
},
"required": [
"key",
"selector",
"value_type"
],
"additionalProperties": false
}
},
"goals": {
"type": "array",
"minItems": 1,
"description": "What success looks like; the first is the one the bandit optimizes.",
"items": {
"type": "object",
"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": {
"type": "string",
"enum": [
"click",
"submit"
],
"description": "click for a button or link, submit for a form."
}
},
"required": [
"name",
"selector",
"dom_event"
],
"additionalProperties": false
}
},
"variants": {
"type": "array",
"minItems": 2,
"description": "Exactly one is the control: the page's current copy, setting every field.",
"items": {
"type": "object",
"properties": {
"contents": {
"type": "object",
"description": "Field key to value."
},
"is_control": {
"type": "boolean",
"description": "True for the control only."
}
},
"required": [
"contents"
],
"additionalProperties": false
}
}
},
"required": [
"name",
"page_url",
"fields",
"goals",
"variants"
],
"additionalProperties": false
}🟢surface_traffic(surface_id, start_date, end_date)
Sessions per day for a surface, as {date, sessions}. With no dates, every recorded day. For conversion and winners, use surface_results.
Eingabe-Schema
{
"type": "object",
"properties": {
"surface_id": {
"type": "integer",
"description": "The surface id, from surface_list."
},
"start_date": {
"type": "string",
"description": "First day, YYYY-MM-DD."
},
"end_date": {
"type": "string",
"description": "Last day, YYYY-MM-DD."
}
},
"required": [
"surface_id"
],
"additionalProperties": false
}🔴surface_update(surface_id, name, description, status, page_url, ...)
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.
Eingabe-Schema
{
"type": "object",
"properties": {
"surface_id": {
"type": "integer",
"description": "The surface id, from surface_list."
},
"name": {
"type": "string",
"description": "Unique within the organization."
},
"description": {
"type": "string",
"description": "Note shown in the dashboard."
},
"status": {
"type": "string",
"enum": [
"ACTIVE",
"ARCHIVED"
],
"description": "ACTIVE serves variants; ARCHIVED stops serving."
},
"page_url": {
"type": "string",
"description": "The live URL of the page."
},
"location": {
"type": "string",
"enum": [
"WORLDWIDE",
"UNITED_STATES",
"EUROPE",
"ASIA_PACIFIC"
],
"description": "Serving region."
}
},
"required": [
"surface_id"
],
"additionalProperties": false
}🟡variant_create(surface_id, variants)
Add variants to a surface, as DRAFT; activate them with variant_set_status. Returns the surface's full variant list.
Eingabe-Schema
{
"type": "object",
"properties": {
"surface_id": {
"type": "integer",
"description": "The surface id, from surface_list."
},
"variants": {
"type": "array",
"minItems": 1,
"items": {
"type": "object"
},
"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."
}
},
"required": [
"surface_id",
"variants"
],
"additionalProperties": false
}🟢variant_list(surface_id)
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).
Eingabe-Schema
{
"type": "object",
"properties": {
"surface_id": {
"type": "integer",
"description": "The surface id, from surface_list."
}
},
"required": [
"surface_id"
],
"additionalProperties": false
}🔴variant_set_control(surface_id, variant_id)
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.
Eingabe-Schema
{
"type": "object",
"properties": {
"surface_id": {
"type": "integer",
"description": "The surface id, from surface_list."
},
"variant_id": {
"type": "integer",
"description": "The variant id, from variant_list."
}
},
"required": [
"surface_id",
"variant_id"
],
"additionalProperties": false
}🔴variant_set_status(surface_id, variant_id, status)
Activate, pause or archive a variant. Only active variants are served. To change which variant is the control, use variant_set_control.
Eingabe-Schema
{
"type": "object",
"properties": {
"surface_id": {
"type": "integer",
"description": "The surface id, from surface_list."
},
"variant_id": {
"type": "integer",
"description": "The variant id, from variant_list."
},
"status": {
"type": "string",
"enum": [
"ACTIVE",
"PAUSED",
"ARCHIVED"
],
"description": "ACTIVE serves it; PAUSED and ARCHIVED stop serving it."
}
},
"required": [
"surface_id",
"variant_id",
"status"
],
"additionalProperties": false
}🔴variant_update(surface_id, variant_id, contents)
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.
Eingabe-Schema
{
"type": "object",
"properties": {
"surface_id": {
"type": "integer",
"description": "The surface id, from surface_list."
},
"variant_id": {
"type": "integer",
"description": "The variant id, from variant_list."
},
"contents": {
"type": "object",
"description": "The new contents, in the shape variant_create takes."
}
},
"required": [
"surface_id",
"variant_id",
"contents"
],
"additionalProperties": false
}Community
Nachweis