# Surface and Your AI Agents



<Columns cols="2">
  <Card title="Agents That Drive Surface" icon="terminal" href="/mcp-server/overview">
    Claude, Codex, Cursor, Windsurf, Grok, your own: any MCP client reads and
    writes your workspace through one HTTP endpoint.
  </Card>

  <Card title="Agents That Read Your Site" icon="eye" href="/platform/traffic/analytics">
    Answer engines are a traffic source. AI referrals arrive split out by
    engine, with a lead score attached.
  </Card>
</Columns>

## Agents Driving Surface [#agents-driving-surface]

One endpoint, `https://app.withsurface.com/mcp`, Streamable HTTP, 128 tools. No
local process, no Docker, no per-client SDK.

| Client                                 | Page                                         |
| -------------------------------------- | -------------------------------------------- |
| Claude Desktop, Claude Code, claude.ai | [Claude](/build/agents/claude)               |
| OpenAI Codex                           | [Codex](/build/agents/codex)                 |
| Grok                                   | [Grok](/build/agents/grok)                   |
| Cursor, Windsurf, custom clients       | [Other clients](/build/agents/other-clients) |

Exact config is in [API setup](/mcp-server/setup).

### Two Rules That Apply to Every Client [#two-rules-that-apply-to-every-client]

**Scope is the credential, not the client.** A key or OAuth connection belongs
to one [environment](/concepts#environment) and cannot reach another. `?tools=`
changes what your agent *loads*, never what it is *permitted* to touch.

**Read-only is one parameter.** `?readonly=1` strips every write and admin tool,
whatever the credential could otherwise do.

```
https://app.withsurface.com/mcp?tools=insights&readonly=1
```

## Agents Reading Your Site [#agents-reading-your-site]

* **[Traffic analytics](/platform/traffic/analytics)** breaks out AI
  *referrals*: a human who clicked through from ChatGPT, Perplexity, Claude or
  Gemini, tagged by engine with an average lead score attached.
* **[AI Visibility](/platform/ai-visibility/overview)** measures whether you
  appear in the answers those engines give, per prompt and per model.
* **[Campaign Agents](/platform/campaign-agents/content-agent)** draft the
  material that closes the gaps, as artifacts you review before they publish.

## Reading These Docs with an Agent [#reading-these-docs-with-an-agent]

| What                             | URL                                                            |
| -------------------------------- | -------------------------------------------------------------- |
| Index of every page, in Markdown | [`/llms.txt`](https://docs.withsurface.com/llms.txt)           |
| The whole site as one file       | [`/llms-full.txt`](https://docs.withsurface.com/llms-full.txt) |
| Any single page as Markdown      | append `.md` to its URL                                        |

Every page also links to its Markdown version with
`<link rel="alternate" type="text/markdown">`.

<Tip>
  Point your agent at `/llms-full.txt` for the docs *and*
  [Surface MCP](/mcp-server/setup) for the workspace.
</Tip>