# MCP server (https://www.getfounderhq.com/docs/analytics/ai-resources/mcp-server)

FounderHQ runs an MCP server for this documentation. Connect it once, and
your coding agent searches and reads these pages while it writes your
integration. Setup takes about a minute.

<Callout title="What you need">
  An MCP client that supports HTTP transport. Claude Code, Cursor, and
  most current agent tools do.
</Callout>

The endpoint is:

```
https://www.getfounderhq.com/docs/mcp
```

It is public and read-only. It reads documentation and nothing else. It
never sees your keys, your account, or your data.

## Connect Claude Code

```bash
claude mcp add --transport http founderhq-docs https://www.getfounderhq.com/docs/mcp
```

## Connect another client

Most clients read a JSON config. Add this entry:

```json
{
  "mcpServers": {
    "founderhq-docs": {
      "type": "http",
      "url": "https://www.getfounderhq.com/docs/mcp"
    }
  }
}
```

## The two tools

| Tool | Input | Returns |
| --- | --- | --- |
| `search_docs` | `query` — words or a question | The top 10 matches, each with a title, an absolute URL, and a snippet, as JSON |
| `read_doc` | `path` — a path inside `/docs`, for example `/docs/getting-started` | That page as Markdown |

The normal pattern is search, then read. Your agent calls `search_docs`
to find the right page, then `read_doc` on the URL it found.

`read_doc` accepts a path with or without a leading slash, and tolerates
a trailing `.md`. It refuses anything outside `/docs`.

## Verify it works

Ask your agent a question only these docs can answer. For example:

> Using the founderhq-docs MCP server, what are the four per-event result
> statuses in the Events v2 protocol?

The answer is `ok`, `warning`, `drop`, and `retry`. If your agent names
all four, the connection works. If it guesses or hedges, the server is
not connected.

## Troubleshoot

### The agent says the server has no tools

Confirm you used HTTP transport, not stdio. This server has no command to
run locally; it is a URL.

### The agent answers from memory instead of the docs

Name the server in your prompt: "use the founderhq-docs MCP server".
Agents skip tools they were not pointed at.

### You want the docs without a live connection

Use [`/docs/llms.txt` and the Markdown routes](/analytics/ai-resources/llms-and-markdown-routes)
instead. They need no client support at all.