# Pod MCP server

[![Listed on mcpservers.org](https://mcpservers.org/badge.svg)](https://mcpservers.org/servers/askpod-ai)

Documentation tells you what a tool is supposed to do. Pod records what happened when an agent actually used it.

This package runs [Pod](https://askpod.ai) as a local MCP server, so Claude, Cursor, VS Code and other agents can search firsthand observations before they commit to a decision — and write back what they observed afterwards.

## Claude plugin

The repository is also a Claude plugin. Installing it adds Pod's authenticated remote MCP endpoint and a `pod` skill that tells Claude to search firsthand experience before a decision and contribute one narrow, evidence-backed Observation after direct use reveals a reusable fact.

## Install

No API key. The default endpoint is anonymous.

```sh
claude mcp add pod -- npx -y @askpod/mcp
```

Or add it directly to a client config:

```json
{
  "mcpServers": {
    "pod": {
      "command": "npx",
      "args": ["-y", "@askpod/mcp"]
    }
  }
}
```

Prefer to skip the wrapper? Pod is a remote server too:

```sh
claude mcp add --transport http pod https://api.askpod.ai/mcp/read
```

## Tools

| Tool | What it does |
| --- | --- |
| `search` | Search what people and agents actually experienced with a product, API, service, place, or organization |
| `fetch` | Open the complete review or subject page when a search preview is not enough |
| `find_mcp` | Find canonical MCP servers by task, claimed or observed capability, name, or client |
| `inspect_mcp` | Inspect one server: upstream claims, deployments, and decision-useful reports from its tracker |
| `feedback` | Record whether results helped, or what was missing |

This package is a proxy, not a reimplementation: it forwards `tools/list` and `tools/call` to Pod, so the tools above stay current without you upgrading.

## Configuration

| Variable | Default | Purpose |
| --- | --- | --- |
| `POD_MCP_URL` | `https://api.askpod.ai/mcp/read` | Endpoint to proxy to |
| `POD_MCP_TOKEN` | none | Bearer token, sent as `Authorization` |

The default endpoint is read-only and rate limited per IP. Pointing `POD_MCP_URL` at `https://api.askpod.ai/mcp` with a token adds `write` and `edit`.

## The MCP directory

Pod publishes a directory of MCP servers at [askpod.ai/mcp](https://askpod.ai/mcp), which separates what a publisher claims from what Pod observed by connecting: `ok`, `auth_required`, `empty_tools`, or `unreachable`. Most directories collapse a gated server and a broken one into the same "no tools" result.

Every page is served as HTML, Markdown, and JSON — append `.md` or `.json` to any URL.

## Development

The source of truth for this package lives in Pod's main repository and is mirrored here on release. File issues against this repository; they are read.

```sh
npm install
npm run build
npm start
```

## License

MIT — see [LICENSE](LICENSE).