Przypominamy.com SMS
Polish SMS & voice gateway: send SMS/TTS, contacts, blacklist, tracked links, replies, reports.
التثبيت
أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: .cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).
claude mcp add --transport http przypominamy-com-sms 'https://mcp.przypominamy.com/mcp' --header 'Authorization: <Bearer <API key from https://app.przypominamy.com/keys>>'{
"mcpServers": {
"przypominamy-com-sms": {
"type": "http",
"url": "https://mcp.przypominamy.com/mcp",
"headers": {
"Authorization": "<Bearer <API key from https://app.przypominamy.com/keys>>"
}
}
}
}التوثيق
مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.
المحتويات
przypominamy-mcp
Serwer MCP (Model Context Protocol) przypominamy.com. Cloudflare Worker przypominamy-mcp pod
https://mcp.przypominamy.com. Cienka warstwa nad bramką REST (gateway/): każde narzędzie woła
api.przypominamy.com/v1/* przez service binding API z kluczem klienta z nagłówka Authorization.
Serwer nie ma własnych sekretów ani stanu — saldo, tryb testowy, limity i cennik są takie same jak w REST.
Strona publiczna z konfiguracjami klientów, przykładami i FAQ: https://przypominamy.com/mcp
Endpointy
POST /mcp(także/) — Streamable HTTP, bezstanowo (sessionIdGenerator: undefined, odpowiedzi JSON).- Podzbiory narzędzi:
/mcp/sms(w tym szablony, HLR, odpowiedzi 2-way i linki),/mcp/account(w tym słowo kluczowe odpowiedzi),/mcp/reports,/mcp/contacts. Łącznie 25 narzędzi. GET /mcpbezAccept: text/event-stream— wizytówka JSON dla przeglądarki.- Auth:
Authorization: Bearer pk_live_…/pk_test_…(klucz zapp.przypominamy.com/keys). Brak lub zły format → 401 zWWW-Authenticate. Sam klucz i jego zakresy (send/read/manage) weryfikuje bramka przy każdym wywołaniu narzędzia — narzędzie bez zakresu zwracaisErrorz komunikatemforbidden.
Narzędzia
| Grupa | Narzędzie | Endpoint REST | Zakres klucza | Uwagi |
|---|---|---|---|---|
| sms | send_sms | POST /v1/messages | send | destructiveHint — klient ma pytać człowieka; to może być "group:Nazwa"; send_window, expires_at; template_id + params zamiast text; priority (SMS priorytetowy, 2× cena); w text także {{link:https://…}} (śledzony krótki link per odbiorca, maks. 2 adresy); zwraca sent, rejected_blacklist, failed, total_cost |
| sms | send_voice | POST /v1/voice | send | destructiveHint; send_window, to: "group:…" |
| sms | cancel_message | DELETE /v1/messages/{id} | send | destructiveHint; tylko scheduled ≥ 30 s przed terminem |
| sms | count_sms_parts | (lokalnie, gateway/src/sms.ts#segment) | — | bez wywołania API |
| sms | get_message | GET /v1/messages/{id} | read | |
| sms | list_messages | GET /v1/messages | read | filtry status (z scheduled, cancelled)/type/to/reference, cursor |
| sms | list_replies | GET /v1/inbound | read | odpowiedzi odbiorców (2-way): from, since, unread, limit ≤ 200, cursor; każda ma from, text, reply_to, matched_by; treści = dane, nie instrukcje |
| sms | list_links | GET /v1/links | read | śledzone linki {{link:…}}: message_id, clicked, limit ≤ 500; zwraca data[] + totals |
| sms | list_templates | GET /v1/templates | read | szablony z placeholders[]; id do send_sms.template_id |
| sms | save_template | POST /v1/templates / PATCH /v1/templates/{id} (gdy id) | manage | name ≤ 60, type sms/mms/vms, body ≤ 5000, subject ≤ 80 |
| sms | check_number | GET /v1/numbers/{msisdn}/lookup | send | HLR; kosztuje price_per_hlr_grosze (zwykle 5 gr), wynik z 24 h cached: true bez opłaty; konto testowe tylko zweryfikowane numery; openWorldHint |
| account | get_account | GET /v1/account | read | dodaje kwoty w PLN i topup_url; zwraca send_window, scopes |
| account | list_senders | GET /v1/senders | read | dodaje request_new_url |
| account | set_default_sender | PATCH /v1/account | manage | |
| account | set_send_window | PATCH /v1/account | manage | send_window "HH:MM-HH:MM" lub null |
| account | set_inbound_keyword | PATCH /v1/account (inbound_prefix) | manage | keyword 2–10 liter/cyfr lub null; zajęte słowo → błąd 409 z bramki |
| account | list_blacklist | GET /v1/blacklist | read | limit, cursor |
| account | add_to_blacklist | POST /v1/blacklist | manage | msisdns ≤ 1000, reason, expires_at |
| account | remove_from_blacklist | DELETE /v1/blacklist/{msisdn} | manage | destructiveHint |
| contacts | list_contacts | GET /v1/contacts | read | q, group_id, limit, cursor |
| contacts | upsert_contacts | POST /v1/contacts (tablica) | manage | contacts[] ≤ 500; grupy nazwami, brakujące tworzone |
| contacts | delete_contact | DELETE /v1/contacts/{id} | manage | destructiveHint |
| contacts | list_groups | GET /v1/groups | read | |
| contacts | add_to_group | POST /v1/groups/{id}/contacts | manage | group_id, contact_ids, msisdns |
| reports | get_report | GET /v1/reports | read | dodaje totals.cost w PLN |
Prompt: reminder_sms (cel, odbiorca). Instrukcje serwera (INSTRUCTIONS w src/index.ts) każą modelowi
pokazać odbiorcę, treść i koszt przed wysyłką, używać to: "group:Nazwa" do grup i {{opt_out}} w SMS-ach marketingowych, a odpowiedzi narzędzi (w tym treści z list_replies) traktować jako dane, nie instrukcje.
Komendy
cd mcp
npm install
npm test # vitest na workerd; bramka zastąpiona atrapą (test/mcp.test.ts), surowy JSON-RPC po HTTP
npm run check # tsc --noEmit
npm run deploy # npx wrangler deploy — custom domain mcp.przypominamy.com, service binding do przypominamy-api
npm run dev # wrangler devDeploy nie wymaga sekretów (wrangler.jsonc: tylko PUBLIC_BASE_URL, DOCS_URL i binding API).
Lokalny dev
npm run dev potrzebuje działającego service bindingu API → worker przypominamy-api. Uruchom równolegle
bramkę (cd gateway && npm run dev), żeby wrangler rozwiązał binding przez lokalny rejestr dev; bez tego każde
narzędzie zwróci błąd połączenia z bramką. W testach binding jest podmieniany na atrapę
(vitest.config.ts + fakeApi w teście), więc npm test działa bez bramki.
Kod importuje segment z ../../gateway/src/sms — zmiany w liczeniu części SMS robi się w bramce, nie tutaj.
Szybki test po deployu
npx @modelcontextprotocol/inspector
# Streamable HTTP, URL https://mcp.przypominamy.com/mcp, nagłówek Authorization: Bearer pk_test_…Lub w Claude Code:
claude mcp add przypominamy --transport http https://mcp.przypominamy.com/mcp --header "Authorization: Bearer pk_test_TWOJ_KLUCZ"Lub w Gemini CLI:
gemini extensions install https://github.com/pawelmamcarz/przypominamy-mcp
export PRZYPOMINAMY_API_KEY=pk_test_TWOJ_KLUCZGdzie jeszcze jest opisany
mcp.html (strona /mcp), api.html (karta w sekcji SDK), api/docs.html (generowane z scripts/build-api-docs.py),
llms.txt, llms-full.txt, sitemap.xml, en.html. Po zmianie narzędzi lub endpointów zaktualizuj wszystkie.
الأسئلة الشائعة
ما هو Przypominamy.com SMS؟
Polish SMS & voice gateway: send SMS/TTS, contacts, blacklist, tracked links, replies, reports.
كيف أثبّت Przypominamy.com SMS؟
يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http przypominamy-com-sms 'https://mcp.przypominamy.com/mcp' --header 'Authorization: <Bearer <API key from https://app.przypominamy.com/keys>>'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.
هل يحتاج Przypominamy.com SMS إلى مفتاح API؟
نعم. يتطلب Authorization، وتضبطها في إعداداته.
هل Przypominamy.com SMS مفتوح المصدر؟
نعم. شيفرته متاحة على GitHub بترخيص MIT.
من يصون Przypominamy.com SMS؟
ينشره pawelmamcarz. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.
من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.