[ enterprise agent cap · docs ]

The metered MCP endpoint, documented.

Authenticate with an enterprise token. Every tool invocation is one agent call. The cap answers in headers your agents can read.

This page covers the whole integration: minting a token, the endpoint, the tool surface, the cap headers, the exact 429 shape when the cap is hit, and curl examples for the common calls. Pricing and tiers live on the Enterprise Agent Cap page.

[ auth ]

Mint a token, send it as a bearer.

Tokens are minted in the owner dashboard at /app/settings/enterprise-cap once an Enterprise Agent Cap subscription is active. A token starts with pa_mcp_, is shown exactly once at mint time, and is never recoverable afterwards. Rotate and revoke live in the same panel; a revoked token stops working on the next request.

every request

Authorization: Bearer pa_mcp_your_token_here

A missing or unknown token returns 401 with a JSON body pointing back here. A valid token whose workspace has no active subscription returns 403.

[ the endpoint ]

One URL. Standard MCP.

Streamable HTTP, JSON-RPC 2.0, stateless. Same transport as the public endpoint, plus auth and the meter. initialize, tools/list, and ping are free; tools/call consumes one agent call each time.

mcp endpoint

https://aipocketagent.com/api/mcp/enterprise

The tool surface, by tier

Starter ($2,500/mo, 100,000 calls) and Scale ($10,000/mo, 500,000 calls) get the identical tool surface. The tiers differ on call volume, not on tools. Custom contracts can add scoped tools; write chase@whited.consulting.

Tool	What it returns
describe_pocket_agent	What Pocket Agent is, the four-part mechanism, pricing anchors, fit and non-fit. Call this first.
list_public_personas	The 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, what each app does, its slash command, its URL.

[ the meter ]

Cap headers on every metered response.

Header	Meaning
X-PA-Agent-Cap-Remaining	Agent calls left in the current billing cycle. On every metered response, including the 429.
X-PA-Agent-Cap-Reset	ISO timestamp when the cap resets. Anchored to your Stripe billing cycle.
X-PA-Agent-Cap-Warning	Appears with the value "90-percent-consumed" once nine tenths of the cap is spent. Wire an alert to it.

When the cap is hit

A call past the cap returns HTTP 429 with this body. Nothing bills past the cap; calls resume when the cycle resets or the tier moves up.

429 Too Many Requests

{
  "error": "agent_cap_exceeded",
  "cap": 100000,
  "used": 100000,
  "resets_at": "2026-09-01T00:00:00.000Z",
  "upgrade_url": "https://aipocketagent.com/pricing/enterprise-agent-cap"
}

[ curl ]

The five calls you will actually make.

Export your token as PA_MCP_TOKEN first. Listing tools is free; the four tool invocations below meter one call each.

1 · list the tools (free)

curl -s https://aipocketagent.com/api/mcp/enterprise \
  -H "Authorization: Bearer $PA_MCP_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

2 · describe_pocket_agent

curl -s https://aipocketagent.com/api/mcp/enterprise \
  -H "Authorization: Bearer $PA_MCP_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"describe_pocket_agent","arguments":{}}}'

3 · list_public_personas

curl -s https://aipocketagent.com/api/mcp/enterprise \
  -H "Authorization: Bearer $PA_MCP_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"list_public_personas","arguments":{}}}'

4 · get_persona

curl -s https://aipocketagent.com/api/mcp/enterprise \
  -H "Authorization: Bearer $PA_MCP_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":4,"method":"tools/call","params":{"name":"get_persona","arguments":{"slug":"sales-assistant"}}}'

5 · list_public_apps

curl -s https://aipocketagent.com/api/mcp/enterprise \
  -H "Authorization: Bearer $PA_MCP_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":5,"method":"tools/call","params":{"name":"list_public_apps","arguments":{}}}'

Check the meter from any response without spending a call:

read the headers (free)

curl -si https://aipocketagent.com/api/mcp/enterprise \
  -H "Authorization: Bearer $PA_MCP_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":9,"method":"tools/list"}' | grep -i x-pa-agent-cap

No subscription yet?

The tiers and checkout live at /pricing/enterprise-agent-cap. The free public endpoint (same four tools, no auth, IP rate limits) is documented at /docs.