mcpbeat Sign in

Surf MCP Server

by geckovision Your server? Claim it
answering

Surf is answering right now. Last checked 7 min ago. 267 installs a week from pypi. It exposes 1 tools. Last commit 22 Oct 2026.

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

Installs per day peak 264 · avg 73 · -48% w/w
a month agotoday
Uptime history 91 days of history · worst day 99%
91 days agonow
100.0%
Uptime 24h
91 of 91 checks
1
Tools
read from the server
448 ms
Response time
average over 24h
267
Installs / week
npm and PyPI

What changed 5

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

14 Oct a tool disappeared comprehend_api
26 Sep a tool changed version
20 Sep a tool changed version
4 Sep a tool changed version
31 Aug a tool appeared list_surfaces

What the code does

We read the source, 7 d ago · tools taken from the live server · rules 995398eba69f

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.

File ships in the package but is absent from the source [пакет] gecko/peg_guard.py:1, [пакет] gecko/pegana.py:1
этот файл ставится пользователю, но в репозитории его нет
    return subprocess.run(  # noqa: S603 - fixed argv, no shell, URL pre-validated
  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 7 min ago.

run in your terminal
claude mcp add surf --transport http https://mcp.geckovision.tech/mcp
Settings → Connectors → Add custom connector, then paste this address
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
{
  "servers": {
    "surf": {
      "type": "http",
      "url": "https://mcp.geckovision.tech/mcp"
    }
  }
}

Available tools 1

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

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.

Tools removed

Tools this server used to expose. Anything built against them stopped working on the day they went.

comprehend_api
removed 14 Oct 2026

Endpoints

URLTransportStateLatencyChecked
https://mcp.geckovision.tech/mcp streamable-http answering 423 ms 7 min ago

Alternatives to Surf

same job, measured the same way
veto
by aiveto

Turn OpenAPI services into tools an agent can call under your rules.

local only
Htag Docs
by htagai

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

8 tools answering
OpenAPI Swagger MCP
by nhan7777

Discover, preview, call, and inspect configured Swagger/OpenAPI APIs through 11 fixed tools.

369 installs/wk local only
Universal Connector MCP
by teodormcp

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

122 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.

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

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

45 installs/wk local only
Agent Observability
by kryptosai

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

85 installs/wk local only
Specrun
by pavelpiha

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

local only

Surf — questions

Answers built from our own checks of this server.

What can Surf do?
It exposes 1 tools, read directly from the server on our last check. Among them: 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 448 ms. The bar chart above shows every period we have measured.
Did Surf ever remove tools?
Yes. comprehend_api is no longer exposed — we recorded the date each one disappeared. A tool vanishing usually means a breaking change for anything that depended on it.
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 in the form 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 1 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 448 ms on average, which is faster than 27% of all working MCP servers we measure. 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 267 times in the last week. Week over week that is -48%. 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?
The code is open source: it is published under the Apache-2.0 licence, written in Python, 22 stars on GitHub and 2 open issues. The licence covers the code in the repository, not the hosted service at mcp.geckovision.tech, which runs on its operator's own terms.