SmsManager MCP server

SmsManager MCP server je hostovaný server protokolu Model Context Protocol, díky kterému AI asistent (Claude, Cursor, ChatGPT a další) pracuje s vaším účtem SmsManager přímo v konverzaci — pošle zprávu, ověří doručení, vytvoří API klíč, zjistí stav kreditu nebo objedná odesílatele.


Endpoint	`https://app-api.smsmanager.com/functions/v1/mcp`
Transport	Streamable HTTP
Autentizace	OAuth 2.1 s dynamickou registrací klienta — žádné API klíče ke konfiguraci
Rozsah	Jeden přihlášený uživatel SmsManager a jeden workspace, který vyberete při připojení

MCP server je vrstva akcí: operuje reálný účet. Pokud chcete, aby váš coding agent uměl správně psát kód proti SmsManager API, nainstalujte navíc AI skills — vrstvu znalostí. Obě vrstvy se doplňují.

Nástroje send_message a order_service odečítají kredit z vybraného workspace. Asistent by měl před jejich voláním vždy získat vaše potvrzení; u objednávek služeb navíc server nabízí náhled ceny nanečisto (confirm: false).

Dokumentace serveru je udržována v repozitáři github.com/smsmngr/smsmanager-mcp.

Připojení

Claude (desktop / web)
Claude Code
Cursor
ChatGPT / Codex
Ostatní klienti

V nastavení Claude přidejte vlastní konektor (custom connector) s URL serveru:

https://app-api.smsmanager.com/functions/v1/mcp

Claude si nastavení OAuth zjistí sám. Ponechte výchozí volby:

Authentication: Sign in now — server vyžaduje přihlášení.
OAuth client: Register automatically (Dynamic Client Registration).

Přidejte server jedním příkazem:

claude mcp add --transport http smsmanager https://app-api.smsmanager.com/functions/v1/mcp

Poté spusťte /mcp a zvolte přihlášení k serveru smsmanager.

Nejjednodušší cesta je oficiální plugin pro Cursor, který server zaregistruje automaticky a přidá i skills. Alternativně použijte odkaz Add to Cursor nebo server přidejte ručně do mcp.json:

{
  "mcpServers": {
    "smsmanager": {
      "url": "https://app-api.smsmanager.com/functions/v1/mcp"
    }
  }
}

V nastavení ChatGPT zapněte Developer mode a přidejte plugin s URL serveru. Přihlaste se, vyberte workspace a plugin v konverzaci vyvolejte napsáním @.Oficiální SmsManager plugin pro ChatGPT přidává nad server čtyři workflow skills (odeslání s ověřením doručení, nastavení účtu, objednání odesílatele, denní report kampaně) včetně bezpečnostních pravidel — potvrzení před odesláním i objednávkou a cenový náhled nanečisto.

Co se stane při připojení

Přihlášení

Klient otevře prohlížeč s přihlášením do SmsManageru. Použijte stejný účet jako v dashboardu.

Souhlas a výběr workspace

Obrazovka souhlasu ukáže, která aplikace žádá o přístup, a nechá vás vybrat workspace. Připojení je k tomuto workspace pevně vázané.

Nástroje jsou k dispozici

Po schválení je klient připojený a asistent může volat nástroje popsané níže. Začněte třeba dotazem „Kolik mám kreditu?“.

Změna workspace: v MCP klientovi odpojte (revokujte) aplikaci a připojte se znovu — na obrazovce souhlasu pak vyberte jiný workspace.

Jak funguje přístup

Token identifikuje vás jako uživatele SmsManageru. Workspace zvolený při souhlasu si server pamatuje a každé volání nástroje pracuje s ním.
Server vidí jen data, ke kterým máte přístup i v dashboardu. Členství ve workspace se ověřuje při každém požadavku — po jeho ztrátě přístup okamžitě končí.
Odesílání zpráv a objednávky služeb čerpají kredit workspace a používají jeho API klíč na straně serveru. Samotný klíč se AI nikdy nepředává.
Žádný API klíč nikde nekonfigurujete; přístup odvoláte v MCP klientovi (odpojením aplikace).

Nástroje

Legenda: 🔎 pouze čtení · ✏️ zapisuje / mění stav · 💸 odečítá kredit

Identita a účet

Nástroj	Typ	Popis
`whoami`	🔎	Kdo jste a který workspace toto připojení používá. Obsahuje krátký blok o účtu (aktivován?, stav kontroly, ověřený telefon?, měna). Bez vstupu.
`get_account_status`	🔎	Podrobný stav aktivace a konkrétní další krok: `review_status` (`not_submitted` / `pending` / `approved` / `denied`), ověření telefonu, uložený popis využití a ukázková zpráva. Bez vstupu.

Aktivace účtu se dokončuje v prohlížeči. Ověření telefonu vyžaduje widget s kódem, který nelze automatizovat. Nástroj proto jen hlásí stav a požadavky; asistent vám pomůže připravit popis využití (min. 11 znaků) a ukázkovou zprávu (min. 6 znaků) a aktivaci dokončíte na app.smsmanager.com/app/account-verify.

Zprávy

Nástroj	Typ	Popis
`send_message`	✏️💸	Odešle skutečnou SMS až 10 příjemcům. Parametry: `to` (pole čísel v E.164 bez `+`, např. `420777123456`, 1–10 položek), `text` (1–1000 znaků), volitelně `sender` (registrované ID odesílatele; bez něj se použije výchozí odesílatel workspace). Vrací `request_id` a `message_id` pro každého příjemce. Příjemce v poli `rejected` nebyl odeslán (špatné číslo nebo nedostatek kreditu).
`get_message_status`	🔎	Stav doručení jedné zprávy podle `message_id`. `delivery_code` `201` = doručeno, `202` = přečteno. Neznámé ID vrací `message: null` (není to chyba).
`list_messages`	🔎	Odeslané zprávy za jeden den (`date` ve formátu `YYYY-MM-DD`), volitelně filtr `tag` a `phone_number`. Stránkuje se kurzorem — vrácený `next_cursor` předejte jako `cursor`.
`list_inbox`	🔎	Přijaté (příchozí) zprávy za jeden den (`date`).

API klíče

Nástroj	Typ	Popis
`list_apikeys`	🔎	Seznam podřízených API klíčů („aplikací“) workspace s poznámkou, rozsahem a stavem.
`create_child_apikey`	✏️	Vytvoří nový podřízený klíč pro integraci a vrátí ho. Parametry: `note` (název aplikace / integrace), volitelně `scope` (`api` = jen odesílání a čtení, výchozí; `full` = všechna oprávnění), `share_senders` (smí klíč používat odesílatele workspace; výchozí `true`), `currency` (`CZK` nebo `EUR`; výchozí měna workspace).

Vrácený klíč je živý přihlašovací údaj. Použijte ho v integraci a nesdílejte hlavní klíč workspace. Podrobnosti o sub-klíčích najdete v Autentizaci.

Kredit a fakturace

Nástroj	Typ	Popis
`get_credit`	🔎	Aktuální zůstatek kreditu a měna účtu. Bez vstupu.
`get_billing_details`	🔎	Fakturační údaje (název, adresa, IČO, DIČ). Prázdná pole znamenají, že fakturace ještě není nastavená. Bez vyplněné fakturace nelze dobít kredit.
`set_billing_details`	✏️	Vyplní nebo upraví fakturační údaje. Předejte jen pole, která chcete změnit — ostatní zůstanou zachována. Pole: `name`, `email`, `street`, `city`, `zip`, `country` (ISO 3166-1 alpha-2, např. `CZ`), `company_id` (IČO), `company_vat` (DIČ).
`get_topup_details`	🔎	Platební instrukce pro dobití bankovním převodem — číslo účtu, IBAN, variabilní symbol. Převod provedete sami; kredit se připíše po zpracování platby. Dobití kartou je v dashboardu. Bez vstupu.

Služby (odesílatelé, čísla)

Nástroj	Typ	Popis
`list_services`	🔎	Katalog placených služeb k objednání (alfanumerické ID odesílatele, vyhrazená virtuální čísla, SIM hosting…) se zřizovacím a měsíčním poplatkem v jednotlivých měnách. Slouží k nalezení `service_id`. Bez vstupu.
`order_service`	✏️💸	Objedná placenou službu. Parametry: `service_id` (z `list_services`, např. `sender_sms_420_alnum`), volitelně `period` (`once` / `month` / `quarter` / `year`; minimum služby může mít přednost), `subject` (u „definovaných“ služeb text odesílatele nebo číslo; u služeb přidělovaných z poolu vynechte), `payload` (pole specifická pro službu, např. `{ "country": "CZ", "proofName": "…" }`) a `confirm` (výchozí `false` = náhled ceny nanečisto bez platby; `true` = skutečná objednávka).
`cancel_service`	✏️	Označí placenou službu ke zrušení na konci předplaceného období (bez vrácení peněz; zůstává aktivní do `active_until`). Idempotentní. Parametry: `service_id` a přesný `subject`, se kterým byla služba objednána.

order_service volejte vždy nejdřív s confirm: false, zkontrolujte vrácený total_fee a teprve potom zopakujte volání s confirm: true.

Typické scénáře

Odeslat a ověřit doručení send_message → uložte message_id → get_message_status (nebo list_messages pro přehled celého dne). Dobít kredit bankovním převodem get_billing_details → pokud jsou údaje prázdné, set_billing_details → get_topup_details → proveďte převod s uvedeným variabilním symbolem. Objednat alfanumerického odesílatele list_services (najděte service_id) → order_service s confirm: false (zkontrolujte cenu) → order_service s confirm: true. Aktivovat účet get_account_status → asistent pomůže sepsat popis využití a ukázkovou zprávu → ověření telefonu a odeslání ke kontrole dokončíte na app.smsmanager.com/app/account-verify. Připojit novou integraci create_child_apikey → vrácený klíč použijte v integraci (a kód k ní vám pomohou napsat AI skills).

Omezení

Jedno připojení = jeden workspace. Změna workspace znamená opětovné připojení.
Aktivaci účtu (ověření telefonu, odeslání ke kontrole) dokončíte v prohlížeči — nástroje čtou stav a pomáhají s přípravou, ale nemohou ji odeslat.
get_topup_details vrací pouze instrukce pro bankovní převod; dobití kartou je v dashboardu.
send_message odesílá pouze SMS. Pro Viber, WhatsApp, RCS, omnikanálový flow, plánování nebo hromadné kampaně použijte JSON API v2 — kód k tomu vám pomohou napsat AI skills.

MCP server, nebo skills?

	MCP server	Skills
Co to je	Nástroje, kterými asistent operuje reálný účet	Znalosti API pro coding agenty
Typický úkol	„Pošli zprávu, zkontroluj kredit, vytvoř klíč…“	„Napiš integraci, která…“
Přihlášení	OAuth přihlášení do SmsManageru, bez API klíčů	Není potřeba (API klíč až pro spuštění kódu)
Kde běží	Hostovaný server SmsManager	Lokálně ve vašem agentovi
Vhodné pro	Provozní práci s účtem v konverzaci	Vývojáře píšící vlastní integraci

Další kroky

AI skills

Naučte svého coding agenta správně psát kód proti SmsManager API.

Autentizace

Jak fungují API klíče a sub-klíče, které přes MCP vytvoříte.

Kredit a účtování

Kdy se kredit odečítá a co se stane, když nestačí.

REST API

Stejné operace (klíče, kredit, služby, stav zpráv) přímo přes HTTP.

Odesílání zpráv

Příjem a ověření

Testování

AI asistenti

Přístup a klíče

Připojení

Co se stane při připojení

Jak funguje přístup

Nástroje

Identita a účet

Zprávy

API klíče

Kredit a fakturace

Služby (odesílatelé, čísla)

Typické scénáře

Omezení

MCP server, nebo skills?

Další kroky

AI skills

Autentizace

Kredit a účtování

REST API

​Připojení

​Co se stane při připojení

​Jak funguje přístup

​Nástroje

​Identita a účet

​Zprávy

​API klíče

​Kredit a fakturace

​Služby (odesílatelé, čísla)

​Typické scénáře

​Omezení

​MCP server, nebo skills?

​Další kroky

AI skills

Autentizace

Kredit a účtování

REST API

Připojení

Co se stane při připojení

Jak funguje přístup

Nástroje

Identita a účet

Zprávy

API klíče

Kredit a fakturace

Služby (odesílatelé, čísla)

Typické scénáře

Omezení

MCP server, nebo skills?

Další kroky