surf
Point Gecko at an OpenAPI spec; get first-call-correct, auth-hidden agent tools.
Should I use this
Quality & Safety
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"surf": {
"command": "uvx",
"args": [
"gecko-surf"
]
}
}
}Runnable packages
0.2.0stdioRemote endpoints
https://mcp.geckovision.tech/mcpstreamable-httpWhat it can do
Tool inventory
Tools (2)
🟢comprehend_api(url, from_docs)
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.
Input Schema
{
"type": "object",
"properties": {
"url": {
"type": "string",
"description": "The API's OpenAPI spec URL (or a docs page URL if from_docs)."
},
"from_docs": {
"type": "boolean",
"description": "Recover the surface from a human docs page instead of an OpenAPI spec. Results are quarantined pending review.",
"default": false
}
},
"required": [
"url"
]
}🟢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.
Input Schema
{
"type": "object",
"properties": {},
"additionalProperties": false
}Community
Evidence