Agent Surface is an MCP server published by dev.agentsurface, hosted at agentsurface.dev. When last checked on 2026-11-21 it was working: it answers and lists its tools. It declares 3 tools, including search, list_pages, get_page.
Search and read the Agent Surface guide to making websites, apps, APIs and CLIs work with AI agents.
1,093 connections through 5 shared values. Tap any node.
Inferred from the host name and headers: what a server runs on, not who runs it.
Use when you know the topic but need authoritative pages. Searches titles, descriptions, headings and body; deduplicates chunks into pages in Fumadocs full-text relevance order (ZBSearch). Rank is a position, not confidence. Read a result with get_page; narrow query or section if has_more is true.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Maximum pages to return, from 1 to 20; defaults to 5. |
| query * | string | Keywords to find in documentation titles, descriptions, headings and body; 2 to 500 characters. |
| section | string | Optional top-level docs section, for example discovery, mcp-servers or retrievability; root is the docs index page. Unknown sections return no matches. |
None yet. Changes appear after a server's second daily check.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
{
"name": "search",
"title": "Search documentation",
"description": "Use when you know the topic but need authoritative pages. Searches titles, descriptions, headings and body; deduplicates chunks into pages in Fumadocs full-text relevance order (ZBSearch). Rank is a position, not confidence. Read a result with get_page; narrow query or section if has_more is true.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"query"
],
"properties": {
"limit": {
"type": "integer",
"default": 5,
"maximum": 20,
"minimum": 1,
"description": "Maximum pages to return, from 1 to 20; defaults to 5."
},
"query": {
"type": "string",
"maxLength": 500,
"minLength": 2,
"description": "Keywords to find in documentation titles, descriptions, headings and body; 2 to 500 characters."
},
"section": {
"type": "string",
"pattern": "^[a-z0-9-]+$",
"description": "Optional top-level docs section, for example discovery, mcp-servers or retrievability; root is the docs index page. Unknown sections return no matches."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"results",
"has_more",
"ranking"
],
"properties": {
"ranking": {
"type": "string",
"description": "Explanation of the relevance ordering and rank semantics."
},
"results": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"title",
"description",
"url",
"slug",
"snippet",
"rank"
],
"properties": {
"id": {
"type": "string",
"description": "Stable documentation path, independent of rank."
},
"url": {
"type": "string",
"format": "uri",
"description": "Canonical source URL; pass this to get_page."
},
"rank": {
"type": "integer",
"maximum": 20,
"minimum": 1,
"description": "1-based position within this result set, lower is earlier; not confidence and not comparable across queries."
},
"slug": {
"type": "string",
"description": "Slash-separated docs slug for /api/md; index identifies the docs home."
},
"title": {
"type": "string",
"description": "Published page title."
},
"snippet": {
"type": "string",
"maxLength": 600,
"description": "Matching body or heading excerpt, at most 600 characters."
},
"updated_at": {
"type": "string",
"description": "Content revision time, or last verification date where a revision time is unavailable."
},
"description": {
"type": "string",
"description": "Published page summary."
}
},
"additionalProperties": false
},
"maxItems": 20,
"description": "Distinct matching documentation pages, bounded by the caller limit."
},
"has_more": {
"type": "boolean",
"description": "More matching pages exist beyond this limit. Narrow query or section, increase limit up to 20, or browse list_pages."
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Use when you do not know the topic keywords. Browse page identities and URLs, optionally within a section; then get_page to read one. Pages are sorted by URL. Use offset plus limit for the next slice of this static index.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Maximum pages, default 30, maximum 100. |
| offset | integer | Zero-based index offset; add the previous limit for the next slice. Restart after a deployment. |
| section | string | Optional top-level docs section, for example discovery, mcp-servers or retrievability; root is the docs index page. Unknown sections return no matches. |
{
"name": "list_pages",
"title": "Browse documentation",
"description": "Use when you do not know the topic keywords. Browse page identities and URLs, optionally within a section; then get_page to read one. Pages are sorted by URL. Use offset plus limit for the next slice of this static index.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"default": 30,
"maximum": 100,
"minimum": 1,
"description": "Maximum pages, default 30, maximum 100."
},
"offset": {
"type": "integer",
"default": 0,
"maximum": 9007199254740991,
"minimum": 0,
"description": "Zero-based index offset; add the previous limit for the next slice. Restart after a deployment."
},
"section": {
"type": "string",
"pattern": "^[a-z0-9-]+$",
"description": "Optional top-level docs section, for example discovery, mcp-servers or retrievability; root is the docs index page. Unknown sections return no matches."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"pages",
"has_more",
"next_offset"
],
"properties": {
"pages": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"title",
"description",
"url",
"slug"
],
"properties": {
"id": {
"type": "string",
"description": "Stable documentation path, independent of rank."
},
"url": {
"type": "string",
"format": "uri",
"description": "Canonical source URL; pass this to get_page."
},
"slug": {
"type": "string",
"description": "Slash-separated docs slug for /api/md; index identifies the docs home."
},
"title": {
"type": "string",
"description": "Published page title."
},
"updated_at": {
"type": "string",
"description": "Content revision time, or last verification date where a revision time is unavailable."
},
"description": {
"type": "string",
"description": "Published page summary."
}
},
"additionalProperties": false
}
},
"has_more": {
"type": "boolean"
},
"next_offset": {
"type": [
"number",
"null"
]
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Use after search or list_pages to read the authoritative full Markdown of one page, including canonical URL and freshness metadata. This does not fetch external websites. When no page matches, the error result is a problem document whose suggestions name the next tool.
| Parameter | Type | Description |
|---|---|---|
| url * | string | Canonical Agent Surface docs URL or path returned by search or list_pages, for example /docs/discovery/llms-txt. |
{
"name": "get_page",
"title": "Read a documentation page",
"description": "Use after search or list_pages to read the authoritative full Markdown of one page, including canonical URL and freshness metadata. This does not fetch external websites. When no page matches, the error result is a problem document whose suggestions name the next tool.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"description": "Canonical Agent Surface docs URL or path returned by search or list_pages, for example /docs/discovery/llms-txt."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"id",
"url",
"markdown"
],
"properties": {
"id": {
"type": "string"
},
"url": {
"type": "string"
},
"markdown": {
"type": "string"
},
"updated_at": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Search first to find relevant documentation, or list_pages to browse. Then get_page with a canonical URL to read the full Markdown. All tools are public and read-only. Search returns at most 20 pages; narrow query or section when has_more is true.
Names, descriptions and schemas were written by the server and are shown as data.
Shared addresses on big platforms (Cloudflare, Vercel and the like) put unrelated servers together; those are marked shared_infrastructure. A match is a pivot, not a link between operators.