Pushfa MCP
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Pushfa MCP Prepare a push notification for alias user123 and show the preview before sending."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
MCP پوشفا
MCP رسمی پوشفا برای خواندن راهنمای نصب وب، اندروید و iOS و کار با وبسرویسهای یک سرویس پوشفا. روی سیستم شما با stdio اجرا میشود و برای دریافت راهنما و عملیات سرویس به pushfa.com متصل میشود.
بسته در npm · صفحهٔ نصب و دانلود · مستندات فنی MCP
نصب
به Node.js نسخهٔ ۲۲ یا بالاتر و کلاینتی با پشتیبانی از MCP محلی نیاز دارید. برای اجرا از npm، این تنظیم را در کلاینتهای دارای قالب mcpServers وارد کنید.
{
"mcpServers": {
"pushfa": {
"command": "npx",
"args": ["-y", "pushfa-mcp"]
}
}
}برای اجرا از GitHub، مقدار فیلد args را با آرایهٔ زیر جایگزین کنید.
[
"--yes",
"--package=git+https://github.com/ehsan-coder/pushfa-mcp.git",
"pushfa-mcp"
]برای نصب دستی، فایل یکپارچه را بگیرید و در تنظیمات کلاینت، فرمان node و مسیر کامل فایل را وارد کنید. اگر مخزن را کلون یا ZIP آن را استخراج کردهاید، node src/index.mjs نیز از ریشهٔ پروژه اجرا میشود. اجرای کد به نصب وابستگی نیاز ندارد.
Related MCP server: OneSignal MCP Server
کلیدها و دسترسیها
برای خواندن راهنماها هیچ کلیدی لازم نیست. برای کار با سرویس، متغیرها را در بخش env تنظیمات محلی اتصال وارد کنید و اتصال را دوباره راهاندازی کنید.
متغیر | کاربرد |
PUSHFA_API_PUBLIC_KEY | کلید عمومی سرویس |
PUSHFA_API_PRIVATE_KEY | کلید خصوصی همان سرویس |
PUSHFA_MCP_ENABLE_SEND | مقدار رشتهای true برای فعالکردن ارسال |
PUSHFA_MCP_ENABLE_MANAGEMENT | مقدار رشتهای true برای عملیات مدیریتی |
با هر دو کلید، ابزارهای استعلامِ وضعیت اعلان و اشتراک، Alias، براکتها و اطلاعات تاپیک فعال میشوند. ابزارهای ارسال به شناسهٔ مخاطب، توکن FCM، Alias، Custom Alias و تاپیک، بسته به نوع اعلان و وبسرویس درخواستی، دسترسی ارسال را میخواهند. ابزارهای مدیریتی شامل تغییر Alias و براکت، عضویت تاپیک، کاربر آزمایشی و ثبت پروفایل و رویداد RetenX هستند.
دستیار ابتدا یک پیشنمایش با pushfa_prepare_* میگیرد. پس از تأیید شما، pushfa_send_notification ارسال را ثبت میکند و pushfa_confirm_management پیشنمایش مدیریتی را اجرا میکند. شناسهٔ پیشنمایش پنج دقیقه در همان پردازش معتبر است و فقط یک بار میتوان برای اجرای عملیات از آن استفاده کرد. کلید خصوصی را در تنظیمات محلی نگه دارید. امکانات سرویس و هزینهها طبق پلن و تعرفهٔ پوشفا محاسبه میشوند.
نمونه درخواست
«راهنمای Web Push پوشفا را بخوان و مراحل لازم برای نصب در این پروژه را انجام بده.»
«وضعیت اعلان با شناسهٔ [شناسه] را بررسی کن و زمان تحویل یا کد خطا را بگو.»
«برای کاربر با Alias [شناسه] اعلان آماده کن و پیش از ارسال پیشنمایش را نشان بده.»
ساختار کد
مسیر | مسئولیت |
src/index.mjs | ورودی برنامه و پروتکل MCP روی stdin و stdout |
src/tools.mjs و src/schemas.mjs | تعریف ابزارها و اعتبارسنجی ورودی |
src/client.mjs و src/config.mjs | اتصال به API پوشفا و تنظیم دسترسی ابزارها |
src/guides.mjs و src/drafts.mjs | خواندن راهنماها و مدیریت پیشنمایشهای یکبارمصرف |
pushfa-mcp.mjs | خروجی یکپارچه برای دانلود و اجرای مستقیم |
بعد از تغییر کد در src/، با npm ci و سپس npm run build فایل یکپارچه را دوباره تولید کنید.
مجوز
کد این مخزن با مجوز MIT منتشر میشود.
Available Tools
1 toolpushfa_read_installation_guideARead-only
Read the current official Markdown guide before installing or upgrading Pushfa in a Web Push, native Android, or native iOS project. The first page includes section offsets; continue with next_offset or jump to a section using the returned revision.
Inputs: platform (required), offset, revision.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 1 tool
Only one tool exists, so there is no possibility of confusing it with another. Its purpose—reading the installation guide—is stated explicitly and unambiguously.
The single name follows a clear snake_case verb_noun pattern (pushfa_read_installation_guide) with a namespaced prefix. With only one tool there is no opportunity to demonstrate consistency across a set, so it cannot earn a full 5.
A single read-only documentation tool is a very thin surface for a server named Pushfa MCP, which suggests broader installation/configuration functionality. Only one tool feels under-scoped for the apparent domain.
The surface covers only reading a guide; there is no way to check versions, validate configuration, or apply/perform installation steps. Even within a documentation scope, no search or section-listing tool accompanies the offset-based paging.
Maintenance
Related MCP Connectors
Send, search, and manage notifications, accounts, and push preferences
Send mobile pings and route human questions, approvals, and handoffs from AI agents.
Interact with the Stitch API using natural language commands.
Send yourself a push notification from an AI assistant. No account, one environment variable.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables interaction with Amazon services through AI assistants, allowing users to search products, manage their cart, view order history, and place orders using natural language.MIT
- FlicenseNot gradedqualityDmaintenanceEnables AI assistants to manage OneSignal push notifications, email, SMS, and user management through natural language. Supports multi-channel messaging, segmentation, templates, analytics, and iOS Live Activities with 50+ tools for complete OneSignal API coverage.1-
- AlicenseAqualityDmaintenanceEnables managing DigitalOcean cloud resources, including Droplets, databases, domains, and more, via natural language.121MIT

Pushpad MCPofficial
AlicenseAqualityCmaintenanceEnables sending web push notifications and managing Pushpad resources (notifications, subscriptions, projects, and senders) through natural language, using the Pushpad API.191MIT