Local multi-channel message emulator for E2E testing with an MCP server for LLM agents. Emulates SMTP, Telegram, WhatsApp, Stripe, FCM, APNs, Web Push, Slack, Discord, GitHub, Facebook, X webhooks, and file transfer protocols (FTP/SFTP).
MockPost MCP has 27 well-named tools with consistent verb_noun patterns (set_, register_, list_, simulate_, get_, create_, delete_). All tools have descriptions (avg ~120 chars, within 10-1024 range). Input schemas are present with type declarations for all parameters. However, parameter descriptions are often terse (10-30 chars), and output schemas are not documented. Error handling is minimal, no recovery guidance, no actionable error messages. Tool composition is sound (each does one thing), but descriptions lack dependency hints and prerequisites. No tool annotations (readOnlyHint/destructiveHint) despite clear risk classifications in metadata.
Create a Web Push subscription and return it shaped exactly like the browser's PushSubscription (endpoint + keys.p256dh + keys.auth). Hand it to the app under test: MockPost keeps the private key, so when the backend sends the encrypted push with pywebpush or web-push it verifies the VAPID signature, decrypts the payload and captures the cleartext.
Delete a registered app. Its webhooks become global.
Delete a registered webhook.
Mark a Web Push subscription as gone: the next push answers 410, which is how a backend learns it must delete a dead subscription.
Generate and store a TOTP secret (Google Authenticator). Returns base32 secret and otpauth:// URL.
Return the runtime configuration for a channel: fake credentials, secrets, endpoints, etc. Useful for handing to the app under test.
No output schemas documented. LLMs cannot infer what fields to expect from tool responses, forcing them to guess at downstream field names and risk broken tool chains.
Parameter descriptions are terse (10-30 chars). E.g., 'Channel to filter by' lacks context on valid values, format, or when to use. Descriptions should be 50-200 chars and include constraints.
No tool annotations (readOnlyHint, destructiveHint, idempotentHint). Tools are marked with Risk metadata (READ_ONLY, WRITE, DESTRUCTIVE) but not exposed to LLM via MCP annotations, limiting agent safety.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | C | 61 | 2026-07-28+ | v2 |
Return the latest OTP code (SMS or email) sent to an identifier.
Return a message's full payload, including raw_payload (MIME/JSON).
Compute the current TOTP code for an identifier.
List registered apps with their fake credentials (MockPost identity).
List Web Push subscriptions with their endpoint and status (active|gone).
List captured messages for a channel (or all), newest first. channel: mail|telegram|whatsapp|webpush|sms|fcm|apns|slack|discord|stripe. app: registered app name to filter only its messages.
Webhook delivery history: what each app returned (code + body), even if it was down (response_code 0). Filterable by channel and app.
List registered webhooks for a channel and/or app.
Register or update an app: bind its FAKE credentials (Telegram bot token, Twilio SID, Stripe sk_test_, WhatsApp phone_id, FCM project_id) to a name. The app talks to MockPost using those credentials as if it were the real service; MockPost identifies it by them. Use the same name to update creds.
Register a webhook URL for a channel and app. MockPost will POST events to this URL.
Set the active app (a name registered in MockPost): incoming event simulations and queries are filtered/delivered only to that app. Pass null/None for no app. Register apps with register_app.
Set the active test_id: all subsequent calls are filtered/persisted with it. Pass null/None to go back to the global queue.
Fire a delivery status webhook (delivered|read|failed) back to the app. Uses POST /whatsapp/simulate/status.
Fire a Facebook Graph API webhook event signed with X-Hub-Signature-256 to the app's registered Facebook webhook. app: registered app name to target; overrides set_app for this call.
Fire a GitHub webhook event (push, issues, pull_request) signed with X-Hub-Signature-256 to the app's registered GitHub webhook. app: registered app name to target; overrides set_app for this call.
Simulate an external user sending an inbound message to the app. channel: telegram (via /telegram/client/sendMessage) or whatsapp. app: registered app name to target; overrides set_app for this call.
Make a native push token look uninstalled: FCM answers 404 UNREGISTERED and APNs answers 410 Unregistered on the next send. channel: fcm | apns
Build and send a simulated Stripe event, signed (Stripe-Signature), to the registered webhook. app: registered app name to target; overrides set_app for this call.
Fire an X (Twitter) Account Activity webhook event signed with X-Twitter-Webhooks-Signature to the app's registered X webhook. payload is a list of event objects, as the real API delivers. app: registered app name to target; overrides set_app for this call.
Verify a Facebook webhook subscription (hub.mode/hub.verify_token/hub.challenge) as Meta does on registration. Returns the challenge URL.
Verify a TOTP code against the stored secret for an identifier.
No error handling guidance. Tools lack recovery hints (e.g., 'If app not found, call list_apps() first'). Errors will not guide LLM to self-correct.
Enum constraints missing for channel/status parameters. E.g., list_sent_messages accepts 'channel' as free-form string; should declare enum: [mail, telegram, whatsapp, webpush, sms, fcm, apns, slack, discord, stripe].