{"service":"pocket-mcp","name":"Pocket MCP server","summary":"Lets an AI agent spend real money inside limits a human set.","description":"Pocket gives each agent its own wallet and a hard cap it cannot raise. This server is how an agent reaches it: one tool buys things, and the other seven exist so the agent does not have to guess what it is allowed to do before it tries.","role":"Protocol adapter. It holds no state and no key of its own; every call is forwarded to the Pocket API as whoever presented the credential.","protocol":{"name":"Model Context Protocol","transport":"streamable-http","endpoint":{"method":"POST","path":"/mcp","url":"http://localhost:8081/mcp"}},"auth":{"scheme":"Bearer","header":"Authorization: Bearer pocket_sk_…","credential":"An organization API key, minted in the Pocket dashboard.","note":"The key travels as a transport header. It is never passed to the model, never returned in a tool result, and never written into the context."},"tools":[{"name":"pocket_list_agents","title":"List agents","description":"List the agents in this organization with their wallet, daily budget and spend so far today.","spends":false,"readOnly":true},{"name":"pocket_get_agent","title":"Get agent","description":"Load one agent with its spending policy, task budgets and wallet balance.","spends":false,"readOnly":true},{"name":"pocket_preview_payment","title":"Preview a payment","description":"Ask whether a payment would be allowed, without recording or settling anything. Always call this before committing to a purchase you are not sure you can afford.","spends":false,"readOnly":true},{"name":"pocket_pay_for_resource","title":"Buy a paid resource","description":"Fetch a URL and, if it responds 402 Payment Required, pay for it through Pocket and return the content. A refusal comes back as \"blocked\" with the remaining budget, so you can pick a cheaper provider. A retry of one that already paid comes back as \"replayed\" with the original receipt: charged once, not twice.","spends":true,"readOnly":false},{"name":"pocket_create_task_budget","title":"Open a task budget","description":"Open a spending envelope scoped to one unit of work.","spends":false,"readOnly":false},{"name":"pocket_spend_summary","title":"Spend summary","description":"Summarise spending over a window, broken down by category and recipient, with anomalies. Use this to answer questions like \"how much did my research agent spend this week, and is anything unusual?\".","spends":false,"readOnly":true},{"name":"pocket_list_payments","title":"List payments","description":"List recent payments, including the ones policy blocked and why.","spends":false,"readOnly":true},{"name":"pocket_audit_trail","title":"Read the audit trail","description":"Read the organization audit trail, newest first.","spends":false,"readOnly":true}],"connect":{"hermes":"hermes mcp add pocket --transport http --url http://localhost:8081/mcp --header \"Authorization: Bearer pocket_sk_...\"","claudeCode":"claude mcp add --transport http pocket http://localhost:8081/mcp --header \"Authorization: Bearer pocket_sk_...\"","config":{"mcpServers":{"pocket":{"type":"http","url":"http://localhost:8081/mcp","headers":{"Authorization":"Bearer pocket_sk_..."}}}}},"links":{"product":"https://www.pocket-app.xyz","documentation":"https://docs.pocket-app.xyz/docs/using/creating-an-agent","protocol":"https://modelcontextprotocol.io","health":"/health"},"release":{"version":"0.1.0","commit":null,"builtAt":null,"startedAt":"2026-11-07T18:30:28.528Z","uptimeSeconds":75861,"environment":"production"}}