Připoj svého agenta k Postbotu

Postbot je MCP server pro AI agenty — Claude, Cursor, ChatGPT a další. Tři kroky, dvě minuty, první dopis bez kreditu i předplatného.

Postbot je MCP server. Vlož jednu adresu do své AI aplikace a agent umí poslat skutečný dopis nástrojem send_letter_cz.

① Vlož adresu serveru

Vyber svou aplikaci a zkopíruj:

claude mcp add --transport http postbot https://postbot.cz/mcp

Nastavení → Connectors → Add custom connector
URL: https://postbot.cz/mcp

Settings → MCP → Add new MCP server
URL: https://postbot.cz/mcp (Streamable HTTP)

Settings → Connectors → Advanced → Developer mode
Add connector: https://postbot.cz/mcp

npm i -g @postbotcz/cli
posta send dopis.md --to-name "Jan Novák" --to-street "Dlouhá" --to-house "5" --to-city "Praha" --to-zip "110 00"

② Pošli první dopis

Řekni agentovi: „Pošli doporučený dopis Janu Novákovi, Dlouhá 5, 110 00 Praha…“ Agent dopis připraví a vrátí ti platební odkaz (od 50 Kč). Klikneš, zaplatíš kartou, dopis se odešle. Bez kreditu, bez předplatného.

③ (Volitelné) Kredit na další dopisy

Posíláš častěji? Přihlas se přes Google, dobij kredit (min. 500 Kč) a agent posílá bez karty u každého dopisu. S automatickým dobíjením se nikdy nezastaví.

Jak to vypadáty: pošli doporučený dopis Janu Novákovi, Dlouhá 5, Praha
agent → send_letter_cz({...})
postbot → 402: rails.oneoff.payUrl (110 Kč)
agent: „Dopis je připravený — zaplať tady: …“
ty: [klik, platba kartou]
postbot → ✉ podáno · sledování RR1234567CZ

Co agent smí a nesmí

Bez tvého kliknutí nebo předplaceného kreditu agent neutratí ani korunu.
Každý dopis má pevnou cenu spočítanou předem z vykresleného PDF.
Co se odeslalo vidíš na /account — včetně podacího čísla.

llms.txt · mcp.json · openapi.json · auth.md

Co je /mcp

/mcp je hostovaný MCP server přes Streamable HTTP — nic neinstaluješ. Přidáš URL https://postbot.cz/mcp do svého agenta jako vzdálený konektor a agent získá nástroje send_letter_cz a get_letter_status.

Pro odesílání z předplaceného kreditu se agent přihlásí přes OAuth přímo v konverzaci — klienti jako Claude nebo ChatGPT to zvládnou samy, na tvůj existující Google účet. Žádné kopírování API klíče.

První dopis ale žádné přihlášení nepotřebuje: nekrytý požadavek vrátí HTTP 402 s platebním odkazem přesně na tenhle dopis. Klikneš, zaplatíš kartou, dopis se odešle.

Chceš server provozovat sám? `bunx @postbot/mcp` spustí stdio verzi s vlastními proměnnými prostředí pro Českou poštu — stejná logika, bez závislosti na hostovaném postbot.cz.