SMS pro AI agenty

  • 9 nástrojůpro SMS v MCP serveru: odeslání, hromadné, plánované, stav, zrušení, OTP, kredit, ceník
  • 7 Skillsopen source (MIT), učí programovací agenty API TopSMS
  • 0 Kčza Skills, MCP server i testovací klíče, platíte jen odeslané SMS

Skills naučí vašeho programovacího agenta, jak API TopSMS funguje. Přes MCP server pošle SMS Claude, ChatGPT, Cursor nebo jiný MCP klient. Použijte jedno z nich, nebo obojí.

Založit účet zdarmaZobrazit ceník

10 testovacích SMS, bez platební karty a bez paušálu.

Skills dodají znalost, MCP provede akci

Agent, který vám píše integraci, potřebuje znát API. Asistent, který práci rovnou udělá, potřebuje nástroj, který může zavolat. TopSMS nabízí obojí, na stejném účtu a se stejnými pravidly.

Skills (znalost)

Co
Sedm balíčků v Markdownu (SKILL.md) s přesným tvarem požadavků a odpovědí, limity a malými spustitelnými příklady.
Pro koho
Pro programovací agenty, kteří píšou nebo kontrolují váš kód: Claude Code a další agenty, kteří čtou formát Agent Skills.
Kde běží
V agentovi jako kontext. Bez API klíče, bez volání po síti.

MCP server (akce)

Co
Vzdálený server na adrese https://www.topsms.cz/api/mcp (i https://topsms.eu/api/mcp) s 9 nástroji pro SMS.
Pro koho
Pro asistenty, kteří jednají za vás: claude.ai, ChatGPT, Claude Code, Cursor a další MCP klienty.
Kde běží
U TopSMS. Každé volání nástroje je skutečný požadavek na API vašeho účtu.
Ukázková data

V Claude Code nainstaluje obojí jeden plugin.

Připojení asistenta

Klienti s přihlášením nepotřebují API klíč: vložíte adresu, přihlásíte se k TopSMS a kliknete na Povolit.

claude.ai a aplikace Claude
Settings → Connectors → Add custom connector, URL https://www.topsms.cz/api/mcp, pole OAuth nechte prázdná, Connect, přihlášení do TopSMS, Povolit. Zda je vlastní konektor k dispozici, záleží na tarifu Claude a nastavení vaší organizace.
ChatGPT
Settings → Apps & Connectors, v rozšířeném nastavení zapněte Developer mode, vytvořte konektor se stejnou URL a ověřením OAuth, přihlaste se a povolte. Vývojářský režim je jen v některých tarifech ChatGPT.
Claude Code
Plugin níže nainstaluje sedm Skills a zaregistruje MCP server. Potom /mcp a přihlášení. Nebo přidejte jen server příkazem claude mcp add.
Cursor a další klienti
Server s API klíčem v hlavičce Authorization. Začněte testovacím klíčem, nic neodešle ani neúčtuje.
n8n
Komunitní node n8n-nodes-topsms (Settings → Community Nodes). Umí odeslání, hromadné SMS, stav, plánované úlohy, ověřovací kódy a kredit a dá se přidat jako nástroj do n8n AI Agenta.
# Claude Code: Skills + MCP server v jednom pluginu
claude plugin marketplace add topsms-ghb/topsms-skills
claude plugin install topsms@topsms
# potom v Claude Code /mcp a přihlášení do TopSMS

# Claude Code: jen MCP server
claude mcp add --transport http topsms https://www.topsms.cz/api/mcp

# Cursor (~/.cursor/mcp.json) a další klienti, s (testovacím) API klíčem
{
  "mcpServers": {
    "topsms": {
      "url": "https://www.topsms.cz/api/mcp",
      "headers": { "Authorization": "Bearer CLIENT_ID:SECRET" }
    }
  }
}

Plugin registruje adresu https://topsms.eu/api/mcp; přihlásíte se k ní stejným účtem z www.topsms.cz.

Co umí 9 nástrojů MCP pro SMS

NástrojCo dělá
send_smsOdešle SMS na jedno číslo, hned nebo naplánovaně (send_at), volitelně s vaším odesílatelem
send_bulk_smsStejný text až na 500 čísel, nad 50 příjemců jde dávka do fronty
get_message_statusStav doručení zprávy včetně důvodu nedoručení (errorCode)
get_bulk_jobPrůběh hromadného nebo naplánovaného odeslání
cancel_scheduledZruší naplánované odeslání a vrátí kredit
verify_sendPošle jednorázový ověřovací kód (OTP)
verify_checkZkontroluje kód, který uživatel zadal
get_creditZůstatek kreditu a cena za SMS
get_pricingVeřejný ceník, i bez přihlášení

Každý nástroj volá stejné REST API jako vaše aplikace: stejné ceny, limity, pravidla pro odesílatele i log požadavků. Odesílací nástroje přijímají idempotencyKey, takže opakované volání SMS nepošle dvakrát.

Sedm Skills

Každý Skill je složka se souborem SKILL.md v otevřeném formátu Agent Skills. Agent si načte jen ten, který zrovna potřebuje.

  • Účty (CZK nebo EUR), API klíče, testovací klíče, první SMS v curl, Pythonu, Node.js a PHP, chybové kódy

    Otevřít na GitHubu →

Zdrojový kód a postup instalace (licence MIT): github.com/topsms-ghb/topsms-skills →

Bez Claude Code stačí složky zkopírovat do ~/.claude/skills nebo do adresáře skills jiného agenta.

Bezpečnost a kontrola

  • Při přihlášení uvidíte stránku souhlasu s názvem aplikace a tím, co smí dělat. Heslo zadáváte jen na stránkách TopSMS.
  • Každé přihlášení se v dashboardu v sekci API přístup objeví jako samostatný klíč „OAuth: název aplikace“. Jeho zrušením asistenta odpojíte.
  • Pro klienty s hlavičkou vytvořte samostatný klíč jen s potřebnými oprávněními (send, read), případně s IP whitelistem a nižším limitem požadavků.
  • Testovací klíč nic neodešle ani neúčtuje, vrací skutečné odpovědi a simulované doručenky. Ať si agent nejdřív zkouší tam.
  • Nechte v klientovi zapnuté potvrzování volání nástrojů, asistent se pak před odesláním zeptá. Odesílá se jen z předplaceného kreditu.
  • Skills neobsahují žádné klíče a nic nevolají po síti; jejich ukázkové skripty čtou klíč z proměnných prostředí.
Ukázková data

Časté dotazy

Jaký je rozdíl mezi Skills a MCP serverem? Skills jsou znalost: soubory v Markdownu, které programovacímu agentovi vysvětlí, jak API TopSMS funguje, aby kód, který napíše, byl správně. MCP server je akce: nástroje, které asistent zavolá, aby SMS hned poslal nebo zjistil doručení. Skills běží v agentovi, MCP server u TopSMS.

Potřebuji obojí? Ne. Pro integraci SMS do vlastního kódu stačí Skills. Aby za vás zprávy posílal asistent, stačí MCP server. V Claude Code nainstaluje obojí jeden plugin.

Se kterými AI nástroji to funguje? MCP server funguje s claude.ai a aplikacemi Claude jako vlastní konektor, s ChatGPT ve vývojářském režimu, s Claude Code, Cursorem a dalšími klienty, kteří podporují vzdálený MCP. Pro klienty, kteří spouštějí jen lokální servery, je npm balíček topsms-mcp. Skills používají otevřený formát Agent Skills, se kterým pracuje Claude Code i další agenti.

Kolik to stojí? Skills, MCP server i testovací klíče jsou zdarma. Platíte jen odeslané SMS: 0,88–0,98 Kč za SMS do Česka a na Slovensko podle tarifu, bez měsíčního poplatku.

Může agent poslat SMS bez mého souhlasu? Jen s přístupem, který mu dáte. Nechte zapnuté potvrzování volání nástrojů, na zkoušení použijte testovací klíč a připojení můžete kdykoli zrušit v dashboardu. Odesílá se jen z předplaceného kreditu.

Je to open source? Ano. Skills jsou na GitHubu (topsms-ghb/topsms-skills) pod licencí MIT, lokální MCP balíček topsms-mcp je na npm také pod MIT.

Související řešení

Vyzkoušejte TopSMS zdarma

10 SMS na začátek, bez závazku a bez platební karty. Podpora je k dispozici nonstop a zdarma.

Založit účet zdarmaZobrazit ceník