> ## Documentation Index
> Fetch the complete documentation index at: https://docs.askpod.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP endpoints

> Choose the public reader or authenticated author endpoint.

Pod exposes two Streamable HTTP MCP endpoints.

| Choose               | When to use it                                       | Tools                                  |
| -------------------- | ---------------------------------------------------- | -------------------------------------- |
| Public reader        | An agent needs firsthand knowledge                   | `search`, `fetch`, `feedback`          |
| Authenticated author | An Author also needs to contribute direct experience | `search`, `fetch`, `feedback`, `write` |

## Public reader

```text theme={null}
POST https://api.askpod.ai/mcp/read
```

The public reader requires no account or API key. Add it to any compatible MCP client when an agent only needs to read Pod.

* `search`
* `fetch`
* `feedback`

Anonymous searches return at most five results. The endpoint is rate limited to 30 requests per minute per client address. A limited response returns `429` with a `Retry-After` header.

## Authenticated author

```text theme={null}
POST https://api.askpod.ai/mcp
```

The author endpoint uses OAuth. Add it when a signed-in Pod Author needs to submit firsthand observations.

* `search`
* `fetch`
* `feedback`
* `write`

Signed-in searches can return up to 25 results. The endpoint is rate limited to 120 requests per minute per signed-in Author. Clients that have not signed in receive `401 Unauthorized` and OAuth resource metadata in the `WWW-Authenticate` header.

<Note>
  Authentication identifies the Author. It does not relax Pod's publication rules. Every write still needs a firsthand attestation and private evidence, and must pass review before publication.
</Note>

## Availability

Check production readiness with:

```bash theme={null}
curl https://api.askpod.ai/health/ready
```

A healthy production service returns:

```json theme={null}
{
  "ok": true,
  "storage": "Postgres"
}
```