Agent Surface

dev.agentsurfacePublished by agentsurface.devOfficial publisherv2.3.0Updated Oct 24, 2026

Search and read the Agent Surface guide to making websites, apps, APIs and CLIs work with AI agents.

VerifiedStreamable HTTPWeb executableKnowledge & MemoryDeveloper Tools

Overview

AI-generated overview

A remote MCP server that lets an assistant list, read and search the Agent Surface documentation on making sites, apps, APIs and CLIs work with AI agents.

What you can do
  • List all documentation pages with their pathnames
  • Read the Markdown content of a page by its pathname
  • Search documentation pages with a query
When to use it
Useful when you want an assistant to look up Agent Surface guidance on agent-friendly websites, apps, APIs and CLIs, or to pull a specific guide page into a conversation without leaving the chat.
Requirements
A remote streamable HTTP endpoint at agentsurface.dev; no packages, environment variables or headers are declared, and no authentication is declared.

Installation

In SourceWeft

  1. Open Agent Surface in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/dev.agentsurface%2Fdocs/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "agent-surface": {
      "type": "http",
      "url": "https://agentsurface.dev/mcp"
    }
  }
}

README

Agent Surface

Documentation, specifications, decisions and outstanding work live in Linear (howells, AGE).

sh
pnpm installpnpm devpnpm buildpnpm startpnpm test        # docs integrity checkpnpm typecheck

Source: README.md at commit 88a1cb3

Tools

3

list_pages

List Pages

List all docs pages with their pathnames (URLs)

Takes no parameters.

get_page

Get Page

Get the Markdown content of a docs page by its pathname (URL)

Parametersurlrequired

Version history

1
  1. v2.3.0LatestSep 25, 2026

Score

90% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

    Declare a license in the repository or the registry entry.