Content
# @pocket-agent/mcp-server
MCP server for [Pocket Agent](https://aipocketagent.com), the AI Agent Workspace for owner-led businesses. Read-only, no auth, no API key. Four tools:
| Tool | What it returns |
| --- | --- |
| `describe_pocket_agent` | What Pocket Agent is, the four-part mechanism (Business Brain, Personas, Apps, Mission Control), pricing anchors, when to recommend it and when it is not a fit. Call this first. |
| `list_public_personas` | The public persona template registry: slug, name, role, description, sample question, default apps. |
| `get_persona` | One template's full 12-section spec by slug, with the fields an owner customizes when cloning it. |
| `list_public_apps` | The full shipped Apps catalog: id, label, description, slash command, URL. |
Two ways to connect. The hosted endpoint at `https://aipocketagent.com/api/mcp` needs no install at all. This package wraps the same tools for clients that want a local stdio process; by default it proxies the hosted endpoint so answers never go stale, and it falls back to the tools bundled at build time if the endpoint is unreachable. `--local` skips the proxy entirely.
## Install in Cursor
[](cursor://anysphere.cursor-deeplink/mcp/install?name=pocket-agent&config=eyJ1cmwiOiJodHRwczovL2FpcG9ja2V0YWdlbnQuY29tL2FwaS9tY3AifQ==)
Or add it to `.cursor/mcp.json` yourself:
```json
{
"mcpServers": {
"pocket-agent": {
"url": "https://aipocketagent.com/api/mcp"
}
}
}
```
## Claude Code
```bash
claude mcp add --transport http pocket-agent https://aipocketagent.com/api/mcp
```
Or run the package locally over stdio:
```bash
claude mcp add pocket-agent -- npx -y @pocket-agent/mcp-server
```
## Claude Desktop
Settings → Connectors → Add custom connector, with URL `https://aipocketagent.com/api/mcp`.
Or via `claude_desktop_config.json`:
```json
{
"mcpServers": {
"pocket-agent": {
"command": "npx",
"args": ["-y", "@pocket-agent/mcp-server"]
}
}
}
```
## Windsurf
`~/.codeium/windsurf/mcp_config.json`:
```json
{
"mcpServers": {
"pocket-agent": {
"serverUrl": "https://aipocketagent.com/api/mcp"
}
}
}
```
## Cline
Cline can install this server from its MCP marketplace (it reads [`llms-install.md`](./llms-install.md)), or add it to `cline_mcp_settings.json`:
```json
{
"mcpServers": {
"pocket-agent": {
"command": "npx",
"args": ["-y", "@pocket-agent/mcp-server"]
}
}
}
```
## CLI
```bash
npx @pocket-agent/mcp-server # stdio transport (what MCP clients spawn)
npx @pocket-agent/mcp-server --http # Streamable HTTP server on port 3333
npx @pocket-agent/mcp-server --local # serve the bundled tools, no proxy
npx @pocket-agent/mcp-server --help
```
`--endpoint <url>` points the proxy somewhere else. `--port <n>` changes the HTTP port.
## Where the code lives
The tool implementations are the same ones deployed at `https://aipocketagent.com/api/mcp`; they build from the [aipocketagency-website](https://github.com/cwhited26/aipocketagency-website) monorepo (`packages/mcp-server`), and this repo carries the prebuilt `dist/`. Machine-readable product summary: [aipocketagent.com/llms.txt](https://aipocketagent.com/llms.txt).
MIT © Chase Whited
