mcpbeat Sign in

Surf MCP Server

by geckovision Your server? Claim it
answering

Surf is answering right now. Last checked 14 min ago. 404 installs a week from pypi. It exposes 2 tools. Last commit 17 Sep 2026.

Point Gecko at an OpenAPI spec; get first-call-correct, auth-hidden agent tools.

Installs per day peak 983 · avg 112 · -4% w/w
a month agotoday
Uptime history 48 days of history · worst day 99%
48 days agonow
100.0%
Uptime 24h
91 of 91 checks
2
Tools
read from the server
1038 ms
Response time
average over 24h
404
Installs / week
npm and PyPI

What changed 2

Every tool that appeared, vanished or quietly changed what it asks for. Recorded since 1 September 2026. No other catalogue keeps this.

4 Sep a tool changed version
31 Aug a tool appeared list_surfaces

What the code does

We read the source, 23 h ago · tools taken from the live server · rules 3dff92dd89df

Capabilities

What this server is able to do. For an MCP server this is often the job itself — a terminal server runs commands because that is what it is for. Listed so you know what you are plugging in, not as an accusation.

    return subprocess.run(argv, shell=False, capture_output=True, text=True)
  execFileSync(binary, process.argv.slice(2), { stdio: "inherit" });

Is this your server and something here is wrong? Tell us — corrections are free and do not require a plan.

This code can reach further than it looks

We found places where it runs commands, builds paths or queries from values it is given. None of that is a flaw by itself — it becomes one when the code changes, and code changes quietly between releases. We re-read it on every one.

Three servers free · no card

Connect this server

Endpoint below is the one we actually reach during checks — not the one copied from a README. Last verified 14 min ago.

run in your terminal
claude mcp add surf --transport http https://mcp.geckovision.tech/mcp
~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "surf": {
      "url": "https://mcp.geckovision.tech/mcp"
    }
  }
}
~/.codex/config.toml
[mcp_servers.surf]
url = "https://mcp.geckovision.tech/mcp"
.cursor/mcp.json
{
  "mcpServers": {
    "surf": {
      "url": "https://mcp.geckovision.tech/mcp"
    }
  }
}
.vscode/mcp.json
{
  "mcpServers": {
    "surf": {
      "url": "https://mcp.geckovision.tech/mcp"
    }
  }
}

Available tools 2

Read directly from the server with tools/list, grouped by what they act on. If a tool disappears, we record the date.

comprehend
comprehend_api
Submit an API's OpenAPI URL (or a human docs page URL with from_docs=true) and get it comprehended into first-call-correct agent tools — no integration code. Returns the API name, its usable tools, agent-native artifacts (llms.txt / gecko.json / tools.md), and self-host next steps. Comprehends and returns to YOU only: it does not host, publicly list, or register your API.
surfaces
list_surfaces
Every API surface served on this host, with the MCP URL to reconnect to. Use it when you landed on the host root and need a specific API. Free, instant, and it lists only what the public index lists.

Endpoints

URLTransportStateLatencyChecked
https://mcp.geckovision.tech/mcp streamable-http answering 1043 ms 14 min ago

Alternatives to Surf

same job, measured the same way
Alya — The Hub for Autonomous Agents
by rupert1987

Operator-as-agent MCP hub. 6 tools. First $5 free, then $0.001/call.

27 installs/wk 32 tools answering
Htag Docs
by htagai

Public HTAG discovery for MCP tools, API endpoints, OpenAPI ops, and agents.

5 tools answering
Universal Connector MCP
by teodormcp

Security-first MCP server that connects any OpenAPI, GraphQL, gRPC or SOAP API to AI agents.

74 installs/wk local only
Openapi Dynamic
by mayorandrew

Load OpenAPI 2.x/3.x specs and expose generic tools to discover and call multiple APIs.

54 installs/wk local only
API Test MCP
by thisis-najeeb

Call the real API and check the response against your OpenAPI spec.

40 installs/wk local only
Agent Observability
by kryptosai

Trace AI agent execution: every tool call, every error, every dollar. Open source, local-first.

72 installs/wk local only
Specrun
by pavelpiha

MCP server that converts OpenAPI specs into tools which can query API endpoints

local only
Openapi
by docat0209

Turn any OpenAPI/Swagger spec into MCP tools. Zero config, zero code.

267 installs/wk local only

Surf — questions

Answers built from our own checks of this server.

What can Surf do?
It exposes 2 tools, read directly from the server on our last check. Among them: comprehend_api, list_surfaces. The full list with descriptions is on this page — we take it from the server itself via tools/list, not from a README. How MCP servers expose tools in the first place →
Is Surf working right now?
We send a real MCP handshake every 15 minutes. Over the last 24 hours 91 of 91 checks got a reply (100.0%), average response time 1038 ms. The bar chart above shows every period we have measured.
How do I connect Surf?
Copy the ready config from this page — we generate it for Claude Code, Claude Desktop, Codex, Cursor and VS Code, each with the file path that client actually reads. It is a remote server, so there is nothing to install — the client connects to the address.
Does Surf need an API key?
No. Surf completed a full MCP handshake with us as an anonymous client and listed its tools without asking for anything. All 2 of them are readable on this page. This is what we observed, not what the docs claim.
How fast is Surf?
It answers our handshake in 1038 ms on average, which is faster than 8% of all working MCP servers we measure. That is on the slow side — worth knowing if the tool sits inside an interactive loop. The comparison comes from our own checks across the whole registry, every 15 minutes.
How many people use Surf?
The pypi package gecko-surf was installed 404 times in the last week. Week over week that is -4%. We show installs rather than GitHub stars on purpose: a star is a bookmark, an install is someone actually running it.
Is Surf open source?
Yes — it is published under the Apache-2.0 licence, written in Python, 6 stars on GitHub and 2 open issues. The source link is on this page, so you can read exactly what it does with your data before you connect it.