Pushizo

com.pushizoPublished by pushizo.comOfficial publisherv0.1.0Updated Oct 29, 2026

Push, email, SMS, in-app and journeys. 54 tools: reads and drafts; only test sends.

VerifiedStreamable HTTPWeb executableCommunication & CollaborationData & AnalyticsBusiness & Commerce

Overview

AI-generated overview

Pushizo MCP server lets an assistant read push, email, SMS and in-app campaign data, segments, journeys and analytics, and create draft campaigns and segments.

What you can do
  • List and inspect segments, preview or estimate audience sizes, and find campaigns that include or exclude a segment
  • Read campaigns, their messages, templates and template versions, and render templates with Liquid variables
  • Review journeys, journey runs and per-node statistics
  • Search users and read their tags, attributes, subscriptions and preferences, plus message categories and event definitions
  • Pull analytics: KPI summaries, campaign and variant stats, message, subscription, event and conversion reports, funnels, retention cohorts and organization usage
  • Create draft campaigns and draft segments (write tools, explicit approval required)
When to use it
Useful when you want an assistant to answer questions about Pushizo messaging performance, audiences and journeys, or to prepare draft campaigns and segments for review in the Pushizo dashboard. Not suitable if you need the assistant to actually send, schedule, publish or delete anything, since those tools do not exist here.
Requirements
Either the remote endpoint with OAuth 2.1 browser approval (or a scoped API key as a bearer token), or the local npm package run over stdio. Local use needs Node.js and the PUSHIZO_API_KEY environment variable; optional PUSHIZO_API_URL and PUSHIZO_APP_ID. Read tools need segments:read, analytics:read or users:read scopes; draft tools additionally need mcp:write.
Before you install
The API key is a live credential (hs_live_ prefix) and its scopes decide what the assistant can reach; admin scope opens every tool. Draft tools write records into your Pushizo account, so grant mcp:write only if you want that. User search and user lookups return personal data, so request only what is needed. No send, schedule or delete tools are exposed, and test sends only go to test devices.

Installation

In SourceWeft

  1. Open Pushizo in the dashboard and add it to a workspace.
  2. Connect the required credentials. They are stored privately and never shown on public pages.
  3. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/com.pushizo%2Fmcp/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config. The client completes OAuth sign-in on first connect.

{
  "mcpServers": {
    "pushizo": {
      "type": "http",
      "url": "https://api.pushizo.com/mcp"
    }
  }
}

README

[Pushizo]

[Docs] [API reference] [License: MIT]

English · Türkçe

English

Pushizo MCP server — Model Context Protocol server for Pushizo. AI clients such as Claude, Cursor and VS Code can read segments, campaigns, messages, templates and analytics, and create draft campaigns and segments with explicit approval. There are no send, schedule or delete tools. The remote server works without installation (OAuth 2.1); the local server runs over stdio.

Status: Publishing to npm is in progress.
Durum: npm yayını hazırlanıyor.

Install from GitHub until then · O zamana kadar GitHub'dan kurulum:

bash
npm install -g --allow-remote=root https://github.com/pushizo/pushizo-mcp/releases/download/v0.1.0/pushizo-mcp-server-0.1.0.tgzpushizo-mcp   # PUSHIZO_API_KEY=hs_live_… ortamıyla / with PUSHIZO_API_KEY set

After publication · Yayından sonra:

bash
# Remote server (no install)claude mcp add --transport http pushizo https://api.pushizo.com/mcp
# Local server (stdio)PUSHIZO_API_KEY=hs_live_… npx -y @pushizo/mcp-server

The detailed guide below is in Turkish; code samples are language-neutral. Full documentation: docs.pushizo.com/docs/integrations/mcp · API reference: docs.pushizo.com/docs/api.

Türkçe

Pushizo MCP sunucusu

Pushizo için Model Context Protocol (MCP) sunucusu. Claude, Cursor, VS Code gibi yapay zekâ istemcileri segment, kampanya, mesaj, şablon ve analitik verisini okuyabilir; onaylı modda yalnızca taslak kampanya ve segment oluşturabilir. Gönderim, zamanlama ve silme aracı yoktur; taslaklar panelden gözden geçirilip gönderilir.

Araçlar yalnızca Pushizo public REST API'sini çağırır: yetki (API anahtarı kapsamları), IP izin listesi ve kiracı izolasyonu her çağrıda public API ile birebir aynıdır. Ayrıntılı rehber: docs.pushizo.com/docs/integrations/mcp.

BağlantıNe zamanKimlik
Uzak sunucu https://api.pushizo.com/mcp (Streamable HTTP)Kurulum istemeyen istemciler (Claude.ai, Claude Desktop bağlayıcısı, Claude Code, Cursor, VS Code)OAuth 2.1 (tarayıcıda onay) ya da kapsamlı API anahtarı
Yerel sunucu npx -y @pushizo/mcp-server (stdio)Yerel çalıştırmak ya da kendi kodunuza gömmekPUSHIZO_API_KEY

Uzak sunucu (kurulumsuz)

Claude.ai / Claude Desktop: Settings → Connectors → Add custom connector → URL: https://api.pushizo.com/mcp. Claude tarayıcıda Pushizo yetkilendirme ekranını açar; onayladığınız organizasyon, app ve kapsamlarla çalışır.

Claude Code:

bash
claude mcp add --transport http pushizo https://api.pushizo.com/mcp

Cursor (~/.cursor/mcp.json):

json
{  "mcpServers": {    "pushizo": { "url": "https://api.pushizo.com/mcp" }  }}

VS Code (.vscode/mcp.json):

json
{  "servers": {    "pushizo": { "type": "http", "url": "https://api.pushizo.com/mcp" }  }}

OAuth desteklemeyen istemcilerde Authorization: Bearer hs_live_… başlığıyla kapsamlı bir API anahtarı verilebilir:

bash
curl -s -X POST https://api.pushizo.com/mcp   -H "Authorization: Bearer $PUSHIZO_API_KEY"   -H 'content-type: application/json'   -H 'accept: application/json, text/event-stream'   -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Yerel sunucu (stdio)

bash
PUSHIZO_API_KEY=hs_live_… npx -y @pushizo/mcp-server

Paket pushizo-mcp komutunu da sağlar (npm install -g @pushizo/mcp-server sonrası pushizo-mcp).

Ortam değişkeniZorunluAçıklama
PUSHIZO_API_KEYeveths_live_… API anahtarı. Okuma için segments:read, analytics:read; taslak araçları için ayrıca mcp:write.
PUSHIZO_API_URLhayırAPI kök adresi; varsayılan https://api.pushizo.com. https olmalı; yerel geliştirmede http://localhost:<port> veya http://127.0.0.1:<port> kabul edilir.
PUSHIZO_APP_IDhayırAraçta app_id verilmezse kullanılacak app. App'e bağlı anahtarda gerekmez.

stdout yalnızca MCP iletileri içindir; tanılama ve hata metinleri stderr'e yazılır. Anahtar eksikse veya adres geçersizse süreç 1 koduyla çıkar.

Claude Desktop

claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\):

json
{  "mcpServers": {    "pushizo": {      "command": "npx",      "args": ["-y", "@pushizo/mcp-server"],      "env": {        "PUSHIZO_API_KEY": "hs_live_…",        "PUSHIZO_API_URL": "https://api.pushizo.com",        "PUSHIZO_APP_ID": "app_…"      }    }  }}

Araçlar

AraçTürGerekli kapsam
list_segments, get_segmentokumasegments:read
list_campaigns, get_campaign, list_campaign_messagesokumaanalytics:read
get_analytics_summary, list_templatesokumaanalytics:read
list_messages, get_messageokumaanalytics:read veya notifications:write
create_campaign_draftonaylı mod — yazmamcp:write
create_segment_draftonaylı mod — yazmamcp:write

admin kapsamı tüm araçları açar. Yazma araçları yalnızca taslak oluşturur (kampanya her zaman draft, mcp etiketiyle; segment dinamik) ve asistandan çağırmadan önce kullanıcının açık onayını alması istenir.

Kütüphane olarak

ts
import { createFetchApi, createPushizoMcpServer } from '@pushizo/mcp-server';
const server = createPushizoMcpServer({  api: createFetchApi({ baseUrl: 'https://api.pushizo.com', apiKey: process.env.PUSHIZO_API_KEY! }),  defaultAppId: process.env.PUSHIZO_APP_ID,});// server.connect(<MCP taşıması>)

Geliştirme

Paket Pushizo ana deposunda geliştirilir ve test edilir; bu depo her sürümde oradan otomatik yansıtılır. Kullanmak için npm paketini (@pushizo/mcp-server) ya da uzak sunucuyu tercih edin.

Support · Destek

This repository is mirrored automatically from the Pushizo main repository on every release. Please open an issue instead of a pull request; fixes land in the main repository and ship with the next release. Bu depo her sürümde Pushizo ana deposundan otomatik yansıtılır. Pull request yerine issue açın; düzeltmeler ana depoda yapılır ve bir sonraki sürümle buraya gelir.

Released under the MIT License · MIT lisanslıdır — LICENSE.

Source: README.md at commit 894f02f

Tools

54

list_segments

Segmentleri listele

App’in segmentlerini listeler (ad araması ve sayfalama). Gerekli kapsam: segments:read.

Parametersqlimitapp_idcursor

get_segment

Segment oku

Segment tanımı ve tahmini kitle boyutu. Gerekli kapsam: segments:read.

Parametersapp_idsegment_idrequired

list_campaigns

Kampanyaları listele

Kampanyaları listeler (durum/tür/ad filtresi). Gerekli kapsam: analytics:read.

Parametersqlimitapp_idcursorstatus

get_campaign

Kampanya oku

Kampanya ayrıntısı (kitle, içerik, onay durumu, istatistik). Gerekli kapsam: analytics:read.

Parametersapp_idcampaign_idrequired

list_campaign_messages

Kampanya çalıştırmaları

Kampanyanın mesajları (her çalıştırma bir mesaj) ve sayaçları. Gerekli kapsam: analytics:read.

Parametersapp_idcampaign_idrequired

list_messages

Mesajları listele

Gönderilen mesajlar (API, kampanya, journey) ve teslim sayaçları. Gerekli kapsam: analytics:read veya notifications:write.

Parameterslimitapp_idcursor

get_message

Mesaj oku

Mesaj durumu ve sayaçları. Gerekli kapsam: analytics:read veya notifications:write.

Parametersapp_idmessage_idrequired

get_analytics_summary

Analitik özet

Genel bakış KPI’ları: gönderim, teslim, açılma/tıklama oranları, abonelik büyümesi (son 7/30 gün veya özel aralık). Gerekli kapsam: analytics:read.

Parameterstofromrangeapp_id

list_templates

Şablonları listele

Mesaj şablonları (kanal/ad filtresi). Gerekli kapsam: analytics:read.

Parametersqlimitapp_idcursorchannel

create_campaign_draft

Kampanya taslağı oluştur

[Onaylı mod — yazma] Bu araç Pushizo’da kayıt oluşturur. Yalnızca TASLAK oluşturur, hiçbir mesaj göndermez veya zamanlamaz; API anahtarında `mcp:write` kapsamı olmalıdır. Çağırmadan önce kullanıcıdan açık onay alın. Kampanyayı `draft` durumunda oluşturur. Kitle segment kimlikleriyle verilir; içerik doğrudan veya template_id ile. Örnek içerik: {"headings":{"tr":"Başlık"},"contents":{"tr":"Metin"}}.

Parametersnamerequiredapp_idlabelscontentchannelstemplate_idexcluded_segmentsincluded_segments

create_segment_draft

Segment taslağı oluştur

[Onaylı mod — yazma] Bu araç Pushizo’da kayıt oluşturur. Yalnızca TASLAK oluşturur, hiçbir mesaj göndermez veya zamanlamaz; API anahtarında `mcp:write` kapsamı olmalıdır. Çağırmadan önce kullanıcıdan açık onay alın. Dinamik segment oluşturur (kampanyada kullanılana kadar etkisi yoktur). Tanım biçimi: {"all":[{"field":"tags.plan","op":"eq","value":"pro"},{"field":"last_active_at","op":"within_days","value":30}]}.

Parametersnamerequiredapp_iddefinitionrequireddescription

get_app

App bilgisi

App ayarları: ad, platformlar, varsayılan dil, saat dilimi. Gerekli kapsam: users:read.

Parametersapp_id

get_organization_usage

Organizasyon kullanımı

Plan kotaları, bu ayki kullanım ve aşım tahmini (yalnızca organizasyon geneli anahtar). Gerekli kapsam: analytics:read.

Parametersdays

preview_segment

Segment önizleme

Kaydedilmemiş bir tanımın kitle sayısı ve örnek kullanıcıları (segment oluşturmadan). Gerekli kapsam: segments:read.

Parameterslimitapp_iddefinitionrequired

estimate_segment

Segment kitle tahmini

Kayıtlı segmentin güncel kitle ve kanal bazında abonelik tahmini. Gerekli kapsam: segments:read.

Parametersapp_idsegment_idrequired

list_segment_campaigns

Segmenti kullanan kampanyalar

Segmenti dahil veya hariç tutan kampanyalar. Gerekli kapsam: segments:read.

Parametersapp_idsegment_idrequired

get_campaign_stats

Kampanya istatistikleri

Gönderim, teslim, açılma, tıklama, dönüşüm ve kanal kırılımı. Gerekli kapsam: analytics:read.

Parametersapp_idcampaign_idrequired

get_campaign_variant_stats

A/B varyant istatistikleri

Kampanya varyantlarının metrikleri ve anlamlılık (z-testi) sonucu. Gerekli kapsam: analytics:read.

Parametersapp_idcampaign_idrequired

get_template

Şablon oku

Şablon içeriği (dillere göre başlık/metin, e-posta, SMS…). Gerekli kapsam: analytics:read.

Parametersapp_idtemplate_idrequired

get_template_stats

Şablon performansı

Şablonu kullanan mesajların toplu metrikleri. Gerekli kapsam: analytics:read.

Parametersapp_idtemplate_idrequired

list_template_versions

Şablon sürümleri

Şablonun kayıtlı sürüm geçmişi. Gerekli kapsam: analytics:read.

Parametersapp_idtemplate_idrequired

render_template

Şablon önizleme

Şablonu Liquid değişkenleriyle işler (gönderim yapmaz): örnek kullanıcı tag/özellikleri ve dil ile son hali. Gerekli kapsam: analytics:read.

Parametersuserapp_idchannellanguagecustom_datatemplate_idrequired

list_journeys

Journey’leri listele

Otomasyon akışları (durum ve ad filtresi). Gerekli kapsam: analytics:read.

Parametersqlimitapp_idcursorstatus

get_journey

Journey oku

Journey grafiği (düğümler, kenarlar), giriş/çıkış kuralları ve yayın durumu. Gerekli kapsam: analytics:read.

Parametersapp_idjourney_idrequired

get_journey_stats

Journey istatistikleri

Düğüm bazında giriş/çıkış, bekleyen, hedefe ulaşan ve mesaj metrikleri. Gerekli kapsam: analytics:read.

Parametersapp_idversionjourney_idrequiredall_versions

list_journey_runs

Journey çalıştırmaları

Kullanıcı bazında journey çalıştırmaları (durum, kullanıcı, sürüm filtresi). Gerekli kapsam: analytics:read.

Parameterslimitapp_idcursorstatususer_idversionjourney_idrequired

get_journey_run

Journey çalıştırması

Tek çalıştırmanın adım adım zaman çizelgesi. Gerekli kapsam: analytics:read.

Parametersapp_idrun_idrequiredjourney_idrequired

search_users

Kullanıcı ara

Koşullara uyan kullanıcılar (segment tanımıyla aynı biçim; sayfalı). Kişisel veri içerir, yalnızca gereken kadar isteyin. Gerekli kapsam: users:read.

Parameterslimitapp_idcursordefinitionrequired

get_user

Kullanıcı oku

Kullanıcının kimlikleri, tag’leri, özellikleri ve abonelikleri. Gerekli kapsam: users:read.

Parameterslabelrequiredvaluerequiredapp_id

get_user_journeys

Kullanıcının journey’leri

Kullanıcının içinde bulunduğu ve tamamladığı journey çalıştırmaları. Gerekli kapsam: users:read.

Parameterslabelrequiredvaluerequiredapp_id

get_user_preferences

Kullanıcı tercihleri

Kategori ve kanal bazında abonelik tercihleri. Gerekli kapsam: users:read.

Parameterslabelrequiredvaluerequiredapp_id

list_categories

Mesaj kategorileri

Tercih merkezindeki mesaj kategorileri (varsayılan açık/kapalı, kanallar). Gerekli kapsam: users:read.

Parametersapp_id

list_event_definitions

Özel olaylar

App’te görülen özel olay adları, sayıları ve özellik şemaları. Gerekli kapsam: analytics:read.

Parameterslimitapp_idcursor

get_event_definition

Olay tanımı

Tek olayın özellikleri, ilk/son görülme ve hacmi. Gerekli kapsam: analytics:read.

Parametersnamerequiredapp_id

get_message_report

Teslimat raporu

Gönderim/teslim/açılma/tıklama/başarısızlık; güne, kanala veya kampanyaya göre. Gerekli kapsam: analytics:read.

Parameterstofromapp_idcomparegroup_by

get_subscription_report

Abonelik raporu

Kanal bazında yeni, iptal ve net abonelik eğilimi. Gerekli kapsam: analytics:read.

Parameterstofromapp_idcompare

get_event_report

Olay raporu

Özel olay hacmi; güne veya olay adına göre. Gerekli kapsam: analytics:read.

Parameterstofromnameapp_idcomparegroup_by

get_conversion_report

Dönüşüm raporu

Mesajlara atfedilen dönüşümler ve gelir (kanallar arası son temas). Gerekli kapsam: analytics:read.

Parameterstofromapp_idcomparecampaign_id

run_funnel

Funnel analizi

Sıralı olay adımlarında dönüşüm ve kayıp (2–8 adım, adımlar arası en çok `window_hours`). Gerekli kapsam: analytics:read.

Parameterstofromstepsrequiredapp_idcomparewindow_hours

get_retention_report

Elde tutma (retention)

Haftalık kohort elde tutma tablosu. Gerekli kapsam: analytics:read.

Parametersweeksapp_id

get_engagement_heatmap

Etkileşim ısı haritası

Gün × saat açılma/tıklama yoğunluğu (en iyi gönderim zamanı için). Gerekli kapsam: analytics:read.

Parameterstofromapp_id

get_provider_report

Sağlayıcı raporu

APNs/FCM/HMS/e-posta/SMS sağlayıcı başarı ve hata kodu dağılımı. Gerekli kapsam: analytics:read.

Parameterstofromapp_id

list_in_app_messages

In-app mesajlar

In-app mesajlar (durum filtresi) ve gösterim/tıklama sayaçları. Gerekli kapsam: analytics:read.

Parameterslimitapp_idcursorstatus

get_in_app_message

In-app mesaj oku

Tetikler, görünüm, kitle, sıklık ve istatistikler. Gerekli kapsam: analytics:read.

Parametersapp_idmessage_idrequired

list_web_campaigns

Web kampanyaları

Pop-up, banner ve slide-in kampanyaları. Gerekli kapsam: analytics:read.

Parameterslimitapp_idcursorstatus

get_web_campaign_report

Web kampanyası raporu

Gösterim, tıklama, kapatma ve dönüşüm. Gerekli kapsam: analytics:read.

Parametersdaysapp_idcampaign_idrequired

list_forms

Formlar

Web formları ve gönderim sayıları. Gerekli kapsam: analytics:read.

Parameterslimitapp_idcursorstatus

list_surveys

Anketler

Anketler ve NPS. Gerekli kapsam: analytics:read.

Parameterslimitapp_idcursorstatus

get_survey_report

Anket raporu

Soru bazında yanıt dağılımı ve NPS skoru. Gerekli kapsam: analytics:read.

Parametersdaysapp_idsurvey_idrequired

get_inbox_metrics

Gelen kutusu metrikleri

Canlı sohbet ve birleşik gelen kutusu: konuşma hacmi, ilk yanıt ve çözüm süreleri. Gerekli kapsam: analytics:read.

Parameterstofromapp_idchannel

create_template_draft

Şablon oluştur

[Onaylı mod — yazma] Bu araç Pushizo’da kayıt oluşturur. Yalnızca TASLAK oluşturur, hiçbir mesaj göndermez veya zamanlamaz; API anahtarında `mcp:write` kapsamı olmalıdır. Çağırmadan önce kullanıcıdan açık onay alın. Yeniden kullanılabilir mesaj şablonu oluşturur (tek başına gönderilmez; `mcp` etiketi eklenir). Örnek içerik: {"headings":{"tr":"Sepetiniz sizi bekliyor"},"contents":{"tr":"{{ first_name | default: \"Merhaba\" }}, ürünleriniz hâlâ sepette."}}.

Parametersnamerequiredtagsapp_idchannelcontentrequired

create_journey_draft

Journey taslağı oluştur

[Onaylı mod — yazma] Bu araç Pushizo’da kayıt oluşturur. Yalnızca TASLAK oluşturur, hiçbir mesaj göndermez veya zamanlamaz; API anahtarında `mcp:write` kapsamı olmalıdır. Çağırmadan önce kullanıcıdan açık onay alın. Otomasyon akışını `draft` olarak oluşturur; yayımlamaz. Grafik verilmezse boş taslak açılır ve dashboard düzenleyicisinde tamamlanır. Grafik biçimi get_journey çıktısındaki `graph` ile aynıdır (nodes + edges; giriş düğümü segment veya olay).

Parametersnamerequiredgraphapp_idsettingsdescription

create_in_app_draft

In-app mesaj taslağı oluştur

[Onaylı mod — yazma] Bu araç Pushizo’da kayıt oluşturur. Yalnızca TASLAK oluşturur, hiçbir mesaj göndermez veya zamanlamaz; API anahtarında `mcp:write` kapsamı olmalıdır. Çağırmadan önce kullanıcıdan açık onay alın. In-app mesajı `draft` olarak oluşturur; etkinleştirmez. Örnek: triggers [{"kind":"session_start"}] (diğerleri: session_duration, event, screen, trigger), display {"layout":"modal","blocks":[{"type":"title","text":{"tr":"Yeni özellik"}},{"type":"body","text":{"tr":"Hemen deneyin"}},{"type":"button","id":"ok","text":{"tr":"Tamam"},"action":{"type":"dismiss"}}]}.

Parametersnamerequiredapp_iddisplayrequiredaudienceprioritytriggersrequiredfrequency

send_test_notification

Test cihazlarına test gönder

[Onaylı mod — test gönderimi] App’in TEST CİHAZLARINA gerçek bir test push’u gönderir (gerçek kitleye asla). `subscription_ids` verilirse hepsi test cihazı olmalıdır. API anahtarında `mcp:write` kapsamı olmalıdır; çağırmadan önce kullanıcıdan açık onay alın.

Parametersurldataapp_idcontentsrequiredheadingssubscription_ids

Version history

1
  1. v0.1.0LatestOct 22, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listed15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts