What it does
Test and personalize your site's pages from Claude Code or Codex, and check results. Key required.
- Connects Runs in the cloud
- Account or key Needs Authorization
- Category Developer tools
Use together with
Skills that teach the AI this kind of work; they work alongside this one
andrej-karpathy-skills
A single CLAUDE.md file to improve Claude Code behavior, derived from Andrej Karpathy's observations on LLM coding pitfalls.
Why it ranks here
This one is in the “Apps that connect to AI” tab, which is ordered without stars, in this order
| 1. In Claude’s connector directory | No | |
|---|---|---|
| 2. Tried by our team | No | |
| 3. Works for Thai users | No | |
| 4. Usage without stars | 20/100 | Popularity 0 · Freshness 12 · Still answering 8 · Likes from users +0 |
| 5. Listed on | 2026-11-11 |
Likes from users: 0 · Adds at most 5 points to the order (1 per person). It cannot be bought.
Quality: Passed 2/3 basic checks (shown, not used for ordering)
Install
Pick the AI app you use, then copy the settings.
Let your AI install it with one sentence
Please install Surface AI. Follow https://mcp.popnx.com/i/surface-ai-surface.md, show me the commands and wait for my OK before running them.Paste it into an AI that can work on your computer (such as Claude Code or Cursor). It reads our steps, shows you the commands and waits for your OK. No key, no sign-up. · See the full text your AI reads
Passed 2/3 checks · What you ask goes through the maker’s server (mcp.surface-ai.io) · ✓ Commands checked Nov 17, 2026
First: which AI do you use?
Pick your app and the steps appear below.
Works with Claude · about 5 min
You need a Surface AI key (create it on the maker’s site) · Set it up once on claude.ai or the desktop app, then use it in chat · free accounts can add 1 · on Team/Enterprise an Owner adds it
Sign up and create a Surface AI key
Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.
Open Claude’s Connectors page
CustomizeConnectors
Click “Add” → “Custom” → “Web” and fill in these 2 fields
Copy each value into the field with the same name in Claude, then click Continue
Name · NameSurface AIRemote MCP server URL · Addresshttps://mcp.surface-ai.io/mcp/Under Request headers, add this name and value
Header nameAuthorizationValueBearer <paste your key here>Paste the key only into the app’s field, never into a chat or to anyone
Click Continue past the sign-in settings Claude detected · under Authentication choose what the maker says (Sign in now, Sign in when needed or No sign in), then click Add
Turn it on in a chat
+ConnectorsSurface AI
Try it
Use Surface AI and tell me what you can do for me, then show me one thing✓ If Claude says it is using Surface AI or shows a Surface AI tool in the answer, you are connected
Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version
ChatGPT cannot connect Surface AI yet
Surface AI needs your own key to connect, but OpenAI’s help page only describes OAuth sign-in; there is no key option we could verify
What you can do instead
A · Use an app that can connect Surface AI
- You need a Surface AI key (create it on the maker’s site) · Set it up once on claude.ai or the desktop app, then use it in chat · free accounts can add 1 · on Team/Enterprise an Owner adds it
- You need a Surface AI key (create it on the maker’s site)
- You need a Surface AI key (create it on the maker’s site)
- You need a Surface AI key (create it on the maker’s site)
B · Others in Developer tools that work with ChatGPT
Picked from the most used in the same category, only ones that connect by address with no key
- Sentry✓ ChatGPT
- Compiler Explorer✓ ChatGPT
- GitDiagram✓ ChatGPT
Works with Claude Code · about 5 min
You need a Surface AI key (create it on the maker’s site)
Sign up and create a Surface AI key
Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.
Open Terminal
Mac: press Command+Space and type Terminal · Windows: open PowerShell
Paste this command and press Enter
claude mcp add --transport http --scope user surface https://mcp.surface-ai.io/mcp/ --header 'Authorization: Bearer your-value'Replace “your-value” with your key before pressing Enter
Paste the key only into the app’s field, never into a chat or to anyone
Type /mcp in Claude Code
You should see Surface AI listed as connected
Try it
Use Surface AI and tell me what you can do for me, then show me one thing✓ If Claude Code says it is using Surface AI or shows a Surface AI tool in the answer, you are connected
Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version
Works with Cursor · about 5 min
You need a Surface AI key (create it on the maker’s site)
Sign up and create a Surface AI key
Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.
Fill in your key
In the Surface AI settings, Authorization is empty; add your key and save
Paste the key only into the app’s field, never into a chat or to anyone
Open the AI chat in Cursor in Agent mode
Try it
Use Surface AI and tell me what you can do for me, then show me one thing✓ If Cursor says it is using Surface AI or shows a Surface AI tool in the answer, you are connected
Menu names checked against Cursor’s help page on Nov 11, 2026 · your screen may differ slightly by app version
Works with VS Code · about 5 min
You need a Surface AI key (create it on the maker’s site)
Sign up and create a Surface AI key
Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.
Fill in your key
In the Surface AI settings, Authorization is empty; add your key and save
Paste the key only into the app’s field, never into a chat or to anyone
Open the AI chat in VS Code in Agent mode
Try it
Use Surface AI and tell me what you can do for me, then show me one thing✓ If VS Code says it is using Surface AI or shows a Surface AI tool in the answer, you are connected
Menu names checked against VS Code’s help page on Nov 11, 2026 · your screen may differ slightly by app version
Other apps that use MCP, such as Windsurf, Zed or Gemini CLI, each add servers differently. See how in the app list.
Address for apps that connect over the web
https://mcp.surface-ai.io/mcp/JSON settings are under “For developers” below
For developers: Terminal commands and JSON settings
Over the web
Claude Code
claude mcp add --transport http --scope user surface https://mcp.surface-ai.io/mcp/ --header 'Authorization: Bearer your-value'Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"surface": {
"url": "https://mcp.surface-ai.io/mcp/",
"headers": {
"Authorization": "Bearer your-value"
}
}
}
}VS Code (mcp.json)
{
"servers": {
"surface": {
"type": "http",
"url": "https://mcp.surface-ai.io/mcp/",
"headers": {
"Authorization": "Bearer your-value"
}
}
}
}Values you fill in
- Bearer mak_live_… — create a free key at https://app.surface-ai.io/settings/developers. Needs a client that can send this header, such as Claude Code or Codex; OAuth-only clients (claude.ai, Claude D…
Descriptions are as written by the maker.
These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.
At a glance
- Downloads per weeki
- Not on npm/PyPI
- Verified domain
- ✓ surface-ai.io
- Connection
- Runs in the cloud
- Transport
- streamable-http
- Latest versioni
- 1.0.0
- Categoryi
- Developer tools
- Published to registryi
- Nov 12, 2026
- Code last changedi
- –
- Last checked
- Nov 17, 2026
- Maker
- surface-ai.io
- Repo
- –
- Website
- docs.surface-ai.io
- Registry status
- Active
Which apps can use it
Based on how this server connects and on each app’s own docs, checked Nov 10, 2026.
Connect over the internet in
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatOpen WebUIRaycast
Related guides
What it can do
Tool names and descriptions exactly as the server reported them on Nov 17, 2026. The maker wrote them, not us; we show them as plain text.
surface_getFull details for one surface, including its edge_url and dashboard_url. To open the surface in the dashboard, open dashboard_url.
surface_listList 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_resultsHow 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
surface_setupThe 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 firs
surface_trafficSessions per day for a surface, as {date, sessions}. With no dates, every recorded day. For conversion and winners, use surface_results.
surface_updateChange 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 surfa
variant_createAdd variants to a surface, as DRAFT; activate them with variant_set_status. Returns the surface's full variant list.
variant_listList 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_controlMake 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_statusActivate, pause or archive a variant. Only active variants are served. To change which variant is the control, use variant_set_control.
variant_updateReplace 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.
Basic checksi
We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 19, 2026
- ! Caution
Maker matches the repo
The registry lists no source repo, so we cannot match the publisher (surface-ai.io) to the code
- … Not checked yet
Still maintained
We have not read this repo from GitHub yet
- … Not checked yet
Has a licence
We have not read this repo from GitHub yet
- ✓ Pass
Endpoint responds
Responded in 325 ms (HTTP 200)
- – Not applicable
Sign-in with OAuth
No sign-in needed
- ✓ Pass
No hidden instructions in tool descriptions
Read 11 tool descriptions and found no hidden instructions to the AI
Makers: ask for a re-check or report wrong info
For makers: add a badge to your README
If you made this, paste this code into your README. The badge links back to this page.
[](https://mcp.popnx.com/en/servers/surface-ai-surface)Discussion
Ask, share a tip or report that it does not work. Sorted by what people marked helpful.
No posts yet. Be the first to ask or share.
Posts here are written by users, not the PopNx team.
User reviews
No reviews yet
Compared with others in Developer toolsi
- More stars than 0% of the other 6103 servers in this category
- Published to the registry more recently than 85% of the other 6103 servers in this category
- Basic checks equal to or better than 45% of the other 6103 servers in this category
Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.
Common questions
Is Surface AI safe?
It passed 2 of 3 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.
What keys or codes does it need?
You need to fill in: Authorization
Does it run on my computer or in the cloud?
It runs in the maker’s cloud. Connect over the internet with nothing to install, but what you send passes through the maker’s servers.
Is it still maintained?
The GitHub repo last changed –, and the latest version (1.0.0) reached the registry 7 days ago.
Which apps can use it?
Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. It connects by URL, so apps that accept remote MCP servers work too, such as ChatGPT on the web (full MCP on Business and above; Pro read-only).
What can I use instead?
In the same category: GitDiagram, Appllama, Cloudflare MCP, Omnara, Repowise
Similar alternatives
Same category, other makers, commands already checked. Official ones first, then by stars.
Reading a card:↓ Downloads per weeki★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi
GitDiagram
Architecture diagrams, explanations and Mermaid source for public GitHub repositories.
Appllama
Study screens, flows and paywalls from top-earning iOS apps, then build from what wins.
Cloudflare MCP
Cloudflare MCP servers
Omnara
Deploy durable AI agents with Omnara, an open-source managed-agent platform.
Repowise
Codebase intelligence for AI coding agents: graph, git history, docs, decisions, code health.
| This one Surface AI | GitDiagram | Appllama | Cloudflare MCP | Omnara | Repowise | |
|---|---|---|---|---|---|---|
| Runs where | Runs in the cloud, nothing to install | Runs in the cloud, nothing to install | Runs in the cloud, nothing to install | Runs in the cloud, nothing to install | Runs in the cloud, nothing to install | Cloud or install on your computer |
| Needs a key | Yes | No | No | No | No | No |
| Add with + in Claude | No | No | No | Yes | No | No |
| Basic checks | 2/3 | 4/4 | 4/4 | 4/4 | 4/4 | 5/5 |
| License | – | MIT | MIT | Apache-2.0 | Apache-2.0 | AGPL-3.0 |
| Price | No cost listed in the registry | No cost listed in the registry | No cost listed in the registry | No cost listed in the registry | No cost listed in the registry | No cost listed in the registry |
README from the maker
No README found in the repo