Connect

8 clients · secrets stay placeholders

JSON (mcpServers)Claude CodeCodexOpenCodeCursorVS CodeGemini CLIGoose

{
  "mcpServers": {
    "docs": {
      "type": "http",
      "url": "https://agentsurface.dev/mcp"
    }
  }
}

claude mcp add --transport http docs https://agentsurface.dev/mcp

[mcp_servers.docs]
url = "https://agentsurface.dev/mcp"

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "docs": {
      "type": "remote",
      "url": "https://agentsurface.dev/mcp",
      "enabled": true
    }
  }
}

{
  "mcpServers": {
    "docs": {
      "type": "http",
      "url": "https://agentsurface.dev/mcp"
    }
  },
  "deeplink": "cursor://anysphere.cursor-deeplink/mcp/install?name=docs&config=eyJ0eXBlIjoiaHR0cCIsInVybCI6Imh0dHBzOi8vYWdlbnRzdXJmYWNlLmRldi9tY3AifQ%3D%3D"
}

{
  "servers": {
    "docs": {
      "type": "http",
      "url": "https://agentsurface.dev/mcp"
    }
  }
}

{
  "mcpServers": {
    "docs": {
      "httpUrl": "https://agentsurface.dev/mcp"
    }
  }
}

extensions:
  "docs":
    enabled: true
    name: "docs"
    type: streamable_http
    uri: "https://agentsurface.dev/mcp"
    timeout: 300

Quality 83 / 100good

protocol88 · weight 25

pass
protocol.modernsupports 2026-07-28 (server/discover)
pass
protocol.statelessanswers without a session
pass
protocol.transportstreamable HTTP
warn
protocol.list_ttltools/list declares ttlMs 0, so clients re-fetch it on every use

authorizationn/a · weight 15

n/a
auth.prm, auth.as_metadata, auth.cimdno remote uses OAuth
n/a
auth.secret_in_urlno templated URL

tool hygiene71 · weight 30

pass
tools.descriptionsevery tool has a description
pass
tools.description_lengthdescriptions are concise
pass
tools.schemasevery tool has an object input schema
fail
tools.annotationsno tool declares readOnlyHint or destructiveHint, so clients cannot tell safe calls from risky ones
fail
tools.directory_hintsno tool declares all four of readOnlyHint, destructiveHint, idempotentHint and openWorldHint; missing: search (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); list_pages (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); get_page (readOnlyHint, destructiveHint, idempotentHint, openWorldHint)
pass
tools.token_costabout 140 tokens to load every tool
pass
tools.api_dumptools are not a one-to-one API dump

stability100 · weight 15

pass
stability.changesno tool changes in 30 days
pass
stability.rug_pullno tool changed its meaning under the same name

dependenciesn/a · weight 15

n/a
deps.known_vulns, deps.mcp_sdk_version, deps.resolvableno npm or PyPI package

3 tools, about 140 tokens to load them all · tool set 0322a441ff3e · checked 2026-10-19 11:27 UTC

Tool changes

No tool definition changes recorded. A server's first observation is its baseline; later probes record what changes.

Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed. How it is computed.

Trust 96 / 100

provenance85

liveness100

freshness100

hygiene100

+repository +dns-namespace +website +reachable +uptime-100% +updated-24d-ago

Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed. How it is computed.

Endpoints

remote	auth	reachable	uptime 30d	p50	protocol	last ok
`https://agentsurface.dev/mcp` streamable-http	none	yes	100%	885 ms	2026-07-28	2026-10-19

Tools (3)

`get_page`	Get the Markdown content of a docs page by its pathname (URL)
`list_pages`	List all docs pages with their pathnames (URLs)
`search`	Search docs pages with a query

Schemas: list_tools.

Official server.json

{
  "name": "dev.agentsurface/docs",
  "icons": [
    {
      "src": "https://agentsurface.dev/apple-icon",
      "sizes": [
        "180x180"
      ],
      "mimeType": "image/png"
    }
  ],
  "title": "Agent Surface",
  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
  "remotes": [
    {
      "url": "https://agentsurface.dev/mcp",
      "type": "streamable-http"
    }
  ],
  "version": "2.3.0",
  "repository": {
    "url": "https://github.com/howells/agentsurface",
    "source": "github"
  },
  "websiteUrl": "https://agentsurface.dev",
  "description": "Search and read the Agent Surface guide to making websites, apps, APIs and CLIs work with AI agents."
}