Nuntior — Social, Messaging, Blog & Telecom MCP

Provision a new Nuntior user account, multi-tenant workspace, default brand profile, and live Bearer API key (`ntr_live_...`) in one zero-browser call. Use this tool when an AI agent or developer needs to onboard from scratch without opening a web browser first. Returns the newly created `userId`, `workspaceId`, `defaultProfileId`, live `apiKey`, and a 1-click `claimUrl` so a human owner can optionally claim the workspace in the web console (`https://nuntior.com/app`). If the email already exists, returns a fresh session key for that workspace.

Inspect the authenticated workspace's subscription tier (`free`, `starter`, `builder`, `scale`), active social account connections versus plan quota limits (3, 12, 35, or 100), monthly posts published, API key prefix, Stripe billing status, and connected brand profiles. Use this read-only diagnostic tool before connecting new social accounts or publishing high-volume campaigns to verify quota availability and account readiness. Returns a structured summary object containing `workspace`, `planLimits`, `usage`, `billing`, `profiles`, and `connectedAccounts`.

Generate a live 1-click Stripe Checkout session URL or Stripe Customer Billing Portal link to upgrade a Nuntior workspace subscription. Supports upgrading to `starter` ($19/mo, 12 social connections, 1,500 posts/mo), `builder` ($35/mo, 35 social connections, 10,000 posts/mo), or `scale` ($79/mo, 100 social connections, 50,000 posts/mo + $0.50 per extra connection), plus optional `dedicated_phone` ($1.50/mo E.164 number for SMS, WhatsApp, and SIP Voice AI). Returns `checkoutUrl` (or `portalUrl`), target plan metadata, connection quotas, and user instructions.

Create, list, update, or delete isolated multi-tenant brand or client profiles within a Nuntior workspace, including default timezone, X Smart Link optimization strategy, and automatic media aspect-ratio fitting rules. Use this tool to segment social accounts by brand, business unit, or agency client so credentials and posts never mix across profiles. Returns the list of profiles or the newly created/updated/deleted `Profile` record persisted in Nuntior Cloud.

List connected social accounts, initiate 1-click Managed OAuth 2.0 flows (`connect_oauth`), vault custom Bring-Your-Own-Keys (`connect_byok`) with zero markup and AES-256-GCM encryption, run live upstream API token health checks (`account_health`), or disconnect accounts across 18+ platforms. Use this tool whenever you need to link a new social network, verify OAuth token validity and latency, or inspect which platforms are ready for publishing. Returns account metadata, 1-click `authorizationUrl` links, or live latency/health diagnostics; if the workspace connection quota is full, returns a structured `PLAN_CONNECTION_LIMIT_REACHED` upgrade prompt.

Publish immediately (`publish_now`), schedule for a future ISO-8601 timestamp (`schedule`), enqueue into the profile slot queue (`queue`), or simultaneously cross-post (`cross_post`) content and media across 18+ social networks. Includes the built-in X Smart Link Optimizer (`xLinkStrategy: 'first_reply'`), which automatically strips external links from the main X post and publishes them in an immediate 1st reply—cutting X API link costs by 85% ($0.03 vs $0.20) while avoiding main-feed link reach penalties. Returns the persisted `postId`, per-platform delivery receipts (`platformResults`), total API cost (`totalCostUsd`), and exact dollar savings (`totalSavedViaSmartLinkUsd`).

List, inspect, update, delete, or retry scheduled, queued, and published social media posts stored in Nuntior Cloud. Use this tool to audit the content calendar, edit copy or scheduled timestamps before publication, remove cancelled posts, or automatically retry any failed platform deliveries. Returns matching `ScheduledPost` records with per-platform delivery status and timestamps.

Execute media ingestion, zero-egress storage uploads, automatic multi-aspect-ratio video reframing (`9:16`, `16:9`, `1:1`, `4:5`), viral short clip extraction with burned-in captions, and AI visual asset generation (`media_generate`). Use this tool before `posts_publish` whenever a campaign requires uploading video/image files or converting a single landscape video into vertical Reels, TikToks, and YouTube Shorts. Returns presigned PUT upload URLs, zero-egress CDN URLs, transcoded aspect-ratio variant maps, or extracted clip URLs.

Manage the unified cross-network social and messaging inbox across LinkedIn, X DMs, Instagram, Threads, Telegram, and WhatsApp. Supports listing conversation threads (`list_threads`), reading full message history in a thread (`read_thread`), dispatching outbound replies (`reply`), and marking threads as read (`mark_read`). Returns normalized conversation objects with sender handles, timestamps, direction (`inbound`/`outbound`), and delivery confirmation.

List, reply to, hide, or delete public comments on published social posts, or configure an automated viral Auto-Plug reply (`auto_plug`) that triggers when a post crosses a specified like threshold. Use this tool to engage commenters, remove spam on X/LinkedIn/Instagram/YouTube, or automatically plug a newsletter or product URL underneath high-performing posts. Returns moderation execution status or the active Auto-Plug rule configuration.

Query cross-network engagement analytics (`account_overview`, `post_metrics`, `audience_growth`), compute AI-recommended optimal posting windows (`best_times`), or execute live real-time social listening (`social_listen`) across Bluesky, Hacker News, Dev.to, Reddit, and X. Use `social_listen` to discover live community threads, competitor mentions, and high-intent buyer questions matching any keyword query. Returns aggregated engagement metrics, X Smart Link cost savings, optimal CET/UTC posting slots, or live upstream social signals with direct thread URLs and author handles.

Create, list, pause, resume, inspect metrics, or boost organic posts into paid social ad campaigns across LinkedIn Ads, X Ads, Meta (Facebook/Instagram) Ads, and TikTok Spark Ads with 0% Nuntior ad-spend commission. Use this tool when an organic post performs strongly and should be amplified to a targeted B2B or consumer audience with a controlled daily budget. Returns campaign configuration, status, targeting parameters, and real-time spend/conversion snapshots.

Publish or update long-form Markdown SEO articles directly to the hosted Nuntior Live Reader (`https://nuntior.com/p/:slug`), Ghost CMS, WordPress, Webflow, Dev.to, Medium, or Hashnode. Use this tool for canonical content-first workflows: publish the full technical article first to get a live canonical URL, then pass that URL into `posts_publish` with `xLinkStrategy: 'first_reply'` to syndicate across 18 social networks. Returns the live `articleId`, `slug`, public `url`, `blogMirrorUrl`, and publication timestamp.

Search available E.164 phone numbers, provision dedicated telecom numbers ($1.50/mo vs $59/mo legacy bundles), list active numbers, or bind a number to a SIP/WebRTC Voice AI Agent trunk. Use this tool when an AI agent needs a dedicated SMS, WhatsApp Business Cloud, or inbound/outbound voice phone number in the US, Spain, UAE, UK, or EU. Returns available or provisioned `TelecomNumber` records with capabilities (`sms`, `voice`, `whatsapp`) and SIP trunk URIs.

Send transactional SMS messages ($0.004/msg), dispatch pre-approved WhatsApp Business Cloud template messages (`send_whatsapp_template`), initiate outbound AI Voice calls (`place_call`), or audit the telecom usage ledger (`logs`). Use this tool for instant out-of-band customer notifications, executive alerts, appointment reminders, or autonomous voice follow-ups. Returns dispatch confirmation, `messageId`, E.164 sender/recipient numbers, and exact per-message cost in USD.

Query real-time web and API traffic telemetry, acquisition channel attribution (Smithery, Glama, PulseMCP, Official MCP Registry, Cursor, Claude Code, Grok Bot, n8n, Direct, X, LinkedIn, GitHub), MCP tool call volume, OAuth conversion funnel metrics, geographic distribution, and the live request stream. Use this read-only observability tool to monitor how developers and AI agents discover and invoke Nuntior in production. Returns aggregated counters, channel breakdowns, latency percentiles, and recent event logs.