# Agent Surface

> Agent Surface is a free MCP server for developer tools. Search a practical guide to making websites, apps and APIs usable by AI agents. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** Web, API
- **Website:** https://agentsurface.dev
- **Repository:** https://github.com/howells/agentsurface
- **MCP Registry name:** dev.agentsurface/docs
- **Categories:** developer tools, marketing and SEO
- **Listing updated:** 2026-11-16

## About

Agent Surface is an advice guide rather than a data service. Its server lets an assistant search and read the guide, which is organised around eight themes: discoverability, understandability, connections, permissions, usability, reliability, payments and measurement. The homepage counts 57 recommendations, each marked either as a starting point or as depending on your product.

Examples include letting agents reach public content through crawler access rules, giving pages stable URLs, publishing llms.txt as a documentation index, listing official integrations, packaging plugins for each platform, and advertising agent services through DNS. Under understandability it covers explaining use cases, readable content, page metadata, structured data and publishing prices and terms.

The repository README holds only developer commands, with documentation kept elsewhere. No pricing is stated, and no authentication is mentioned.

## Features

- **Eight themes:** Covers discovery through measurement.
- **57 recommendations:** Marks which apply to every product or only some.
- **Implementation docs:** Detailed pages back each recommendation.
- **Searchable by agents:** Assistants can search and read the guide.
- **Agent-readiness topics:** Includes llms.txt, structured data and API discovery.

## Good for

- Audit a site for agent-readiness
- Learn what to publish so agents can find your product
- Decide how to expose prices and terms to agents
- Plan permissions and payments for agent use

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://agentsurface.dev/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "docs": {
      "url": "https://agentsurface.dev/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "docs": {
      "serverUrl": "https://agentsurface.dev/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

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

## FAQ

### What does it cover?

Discoverability, understandability, connections, permissions, usability, reliability, payments and measurement.

### How many recommendations are there?

The homepage counts 57.

### Is it a data API?

No. It is a guide that agents can search and read.

### Is there pricing?

None is stated.

### Is Agent Surface free?

Yes. Agent Surface is free to use.

### How do I add Agent Surface to Claude Code?

Run this command in your terminal: claude mcp add --transport http docs https://agentsurface.dev/mcp

### What are the best alternatives to Agent Surface?

The closest alternatives to Agent Surface are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.

---
Source: https://ai-powered.com/mcp/agent-surface
