# @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

[![Install MCP Server](https://cursor.com/deeplink/mcp-install-dark.svg)](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