MCP server reference
Ignix exposes 155 tools over the Model Context Protocol, so an AI assistant can publish, answer messages, read analytics and build automations on your behalf. This page lists every one of them and is generated from the server's own registry.
Connecting
The server is remote and speaks Streamable HTTP over HTTPS, with OAuth 2.1 and a consent screen where you choose which workspace the assistant may reach. In the app, the address and the token live in Settings → MCP server.
{ "mcpServers": { "ignix": { "url": "https://app.ignix.social/api/mcp" } } }Reading this list
Each tool is marked read-only (only reads), writes (changes something in Ignix) or destructive (deletes, unpublishes or reaches a real person). Assistants are expected to confirm destructive calls with you first.
Accounts and workspaces
| Tool | What it does | Access |
|---|---|---|
list_accounts | List the social accounts connected to this organization. | read-only |
list_workspaces | List the workspaces (brands / clients) of this organization. | read-only |
check_account_health | List connected accounts that need attention: token expired or about to expire (reconnect / expiring, the human must reconnect them in Ignix), or messaging restricted by Meta on a Facebook Page (restricted: automations for it are paused and resume by themselves once Meta lifts the restriction; check the Page status in Meta Business Suite). | read-only |
get_network_rules | Publishing and automation rules for a social network: character limit, media requirements, supported content types (reel, story, carousel, thread), and which inbox automations that network allows. | read-only |
get_organization | Organization name, timezone and plan. | read-only |
list_account_summary | One-shot overview: every connected account with how many posts it has scheduled and when the next one goes out. | read-only |
sync_accounts | Re-read the accounts from the networks. | writes |
create_workspace | Create a workspace (a separate brand or client, with its own accounts, library and knowledge) or rename an existing one.. | writes |
list_account_media | Images and videos taken from what the accounts have already published (native posts included). | read-only |
Publishing
| Tool | What it does | Access |
|---|---|---|
list_posts | List posts of the organization (drafts, scheduled, published, failed) with their status, target accounts and media.. | read-only |
get_post | Full detail of one post, including per-network options and failure detail.. | read-only |
create_post | Create a post for one or more social accounts. | writes |
update_post | Edit an existing post (typically a draft or a scheduled one): copy, media, target accounts, schedule. | writes |
validate_post | Dry run: check copy and media against every target network (character limits, media requirements, mandatory options) WITHOUT creating anything. | read-only |
schedule_post | Set the date and time of an existing post. | writes |
unschedule_post | Unschedule a SCHEDULED (or pending-approval) post: it goes back to DRAFT, keeping its date as a suggestion, and nothing is published. | writes |
delete_post | Delete a post from Ignix and from the scheduler. | destructive |
unpublish_post | Remove an already published post FROM THE SOCIAL NETWORK. | destructive |
retry_post | Send a failed post to the network again, keeping its content and targets.. | writes |
duplicate_post | Create a draft copy of an existing post, ready to edit and reschedule.. | writes |
recycle_post | Republish a post that already performed well, scheduling it in the next free queue slot.. | writes |
suggest_publish_times | Next free slots in the organization's posting queue, in its timezone. | read-only |
list_pending_approvals | Posts waiting for review when the approval workflow is enabled for this organization.. | read-only |
review_post | Approve a post awaiting review (it is then scheduled or published according to its intent) or reject it back to draft with a reason.. | writes |
get_network_options | Every option a network accepts in networkOptions when creating a post: key, type, whether it is required, and the exact accepted values (Instagram contentType, YouTube privacy, TikTok consent, Pinterest board, Reddit flair…). | read-only |
get_network_choices | Values that only the network can give for a specific account: Pinterest boards, the subreddits the account can post to, Reddit flairs of a subreddit, YouTube playlists, the TikTok privacy levels that account actually allows, the Facebook Pages the account manages, and the LinkedIn company pages it administers. | read-only |
get_subreddit_rules | Posting rules of a subreddit plus Reddit site-wide rules. | read-only |
get_posting_queue | Recurring weekly slots of the organization: the grid used by useQueue and by suggest_publish_times, in the organization timezone.. | read-only |
set_posting_queue | REPLACE the weekly grid of recurring slots. | writes |
bulk_create_posts | Create many posts for the same accounts in one call. | writes |
attach_media_to_post | Add an already hosted image/video URL to a post that exists. | writes |
suggest_post_idea | Propose a ready-to-publish post idea for a given network, based on the brand and limited to what this organization can actually produce (it will not suggest an AI video if no video provider is configured).. | writes |
get_top_posts | Ranking of published posts by engagement in the period, with their metrics, engagement rate and caption. | read-only |
get_posting_cadence | How many posts per week each network gets and the engagement rate at that cadence — the data behind "should we post more or less?".. | read-only |
list_library_posts | Content already published on the networks, INCLUDING posts published natively outside Ignix, with its media. | read-only |
Media and AI content
| Tool | What it does | Access |
|---|---|---|
edit_image | Edit an image you already have: change the background, add or remove an object, restyle it, make a variation. | writes |
generate_image | Generate an image from a text prompt and return a durable public URL ready to pass to create_post as media. | writes |
get_image_quota | AI credits used and left this month. | read-only |
list_media_providers | Video and avatar-video providers that are wired AND have a key configured by this organization. | read-only |
generate_video | Start an AI video generation job (text-to-video, image-to-video, or an avatar reading a script). | writes |
get_media_job | Status of a video generation job. | read-only |
list_avatar_options | Avatars and voices available in an avatar provider with this organization key. | read-only |
upload_media | Put a file that lives on the user's machine into durable Ignix storage and get back a stable https URL. | writes |
import_media | Download a public URL and re-host it on durable Ignix storage, returning a stable URL usable as post media or as the file of a chatbot flow node. | writes |
list_library_media | Images and videos already generated or uploaded by this organization, newest first. | read-only |
write_caption | Write a post caption from an idea, using this organization's brand voice (business description, tone and knowledge base). | writes |
adapt_caption | Rewrite an existing text in the native style and length of a given network (a LinkedIn post is not an X post). | writes |
translate_caption | Translate a text naturally into another language, keeping tone, emojis and hashtags.. | writes |
suggest_hashtags | Up to 5 relevant hashtags for a text, mixing popular and niche ones (few and relevant beats many).. | writes |
plan_content | Plan a piece of content end to end: caption plus, for each slide, its idea and a detailed art-directed image prompt with a shared visual style. | writes |
Appointments
| Tool | What it does | Access |
|---|---|---|
get_booking_settings | How appointments are set up in this workspace: services (duration, buffers, price with its currency, who does them, whether they are charged when booking, and where they happen: Google Meet, the business's own video link or in person), people and rooms (hours, days off, spots), what is asked when booking, the rules (slot step, minimum notice, horizon, reminders, cancellation policy, automatic refund window for paid bookings, review requests, currency), whether Google Calendar is connected, and the public booking page URL. | read-only |
get_booking_availability | Free slots for a service from a given day, honouring hours, days off, spots, buffers and what is already in Google Calendar. | read-only |
create_appointment | Book an appointment on behalf of the business (for example one that came in by phone). | writes |
list_appointments | Upcoming appointments booked through Ignix (web chat, DM, Sparky, booking page or this MCP). | read-only |
cancel_appointment | Cancel an appointment booked through Ignix by id (from list_appointments). | destructive |
list_booking_reviews | Reviews left by customers after an appointment (stars, text, the service, the business reply, and whether it is hidden from the booking page), newest first, plus the visible average. | read-only |
reply_booking_review | Publish (or replace) the business reply to an appointment review; it shows under the review on the public booking page. | writes |
set_booking_review_hidden | Hide an appointment review from the public booking page (and from its average), or show it again. | writes |
set_booking_review_requests | When on, every customer with an email gets a review request by email about an hour after a completed appointment, plus one reminder the next day if they did not answer (appointments that ended more than 3 days ago are not asked). | writes |
Store
| Tool | What it does | Access |
|---|---|---|
get_store | The link-in-bio store of this workspace: its public page URL and name, whether Stripe is connected and can take payments (needed only for paid products; payments go straight to the business's own Stripe, 0% commission from Ignix), whether the seller details required to sell are filled in, and the store file storage used and available. | read-only |
list_store_products | Every product of the store (downloads, bundles, free lead magnets, courses, memberships) with its type, status (draft or published), price, public URL when published, units sold, and the bundles or memberships that include it. | read-only |
get_store_product | One product in detail: price (and strike-through price), stock limit, refund policy, files, the order bump and upsell, units sold, public URL, and what it includes — the module and lesson outline for a course (lesson video uploaded or YouTube, drip days, attachments), the billing interval and included products for a membership, the items of a bundle.. | read-only |
list_store_orders | Paid store orders, newest first (50 per page): buyer, products (and whether each was the order bump), total, discount and coupon, refunded amount, status (paid, refunded, partially refunded, disputed), whether it can still be refunded and whether it is a membership charge (sign-up or renewal). | read-only |
refund_store_order | Refund a store order IN FULL from the business's own Stripe account (the money leaves its Stripe balance, the buyer gets it back and the order is marked refunded). | destructive |
list_coupons | Discount codes of the store: percentage or fixed amount, uses so far and limit, expiry, whether active, and the products they apply to (none = every product). | read-only |
create_coupon | Create a discount code for the store: either a percentage (percentOff) or a fixed amount (amountOff plus currency). | writes |
set_coupon_active | Deactivate a coupon or reactivate it. | writes |
list_members | Subscribers of a membership product: email, name, status (active, past_due while a failed payment is retried, canceled…), price and interval, member since, next renewal and whether they cancelled (keeps access until the end of the paid period). | read-only |
Inbox
| Tool | What it does | Access |
|---|---|---|
suggest_first_comment | Write the first comment to go under a post: the right place for links, an engagement question or extra hashtags.. | writes |
list_conversations | Conversations from the unified inbox: direct messages from every connected network plus the website chat. | read-only |
get_conversation | Message history of a conversation, oldest first. | read-only |
send_message | Send a message in an existing conversation. | destructive |
start_conversation | Open a direct message with someone who has not written first. | destructive |
update_conversation | Change the pipeline stage of a conversation, mark it read, or escalate it to a human (which silences the bot on that thread and notifies the team).. | writes |
list_comments | Published posts that have comments, newest first. | read-only |
get_comment_thread | Comments on a published post, with author and text.. | read-only |
reply_to_comment | Reply publicly to a comment, or send a private direct message to its author (private: true, Instagram and Facebook only, within 7 days of the comment). | destructive |
moderate_comment | Hide a comment from the public (or unhide it). | destructive |
list_reviews | Reviews received (Google Business Profile and other networks that support them), with rating, text and whether they have been answered.. | read-only |
reply_to_review | Publish a public reply to a review. | destructive |
list_tickets | Conversations promoted to support tickets, with number, subject, priority and stage.. | read-only |
list_saved_replies | Canned replies the team has saved. | read-only |
preview_automation | Read a flow the way a customer would experience it: the sequence of messages, buttons and branches. | read-only |
save_reply_template | Maintain the saved replies the team uses in the inbox. | writes |
create_ticket | Promote a conversation to a support ticket, with number, subject and priority, so it stops living only in the inbox. | writes |
create_comment_to_dm | The classic growth automation: someone comments a keyword on a post and automatically receives a direct message. | writes |
manage_welcome_message | The message someone receives the first time they write to an account. | writes |
list_mentions | Mentions found outside the organization's own posts, by its saved searches on X and Reddit, newest first. | read-only |
reply_to_mention | Reply on the network to a mention found by a saved search. | writes |
Contacts
| Tool | What it does | Access |
|---|---|---|
list_contacts | Contacts of the CRM: people who have interacted through any channel, with their tags, email and subscription state.. | read-only |
get_contact | Full detail of a contact: channels they use, tags, custom fields, notes and last interaction.. | read-only |
create_contact | Add a contact to the CRM. | writes |
update_contact | Edit a contact: name, email, company, notes, tags, subscription or blocked state. | writes |
set_contact_field | Write a value into one of the custom fields defined for this organization (list them with list_custom_fields).. | writes |
list_custom_fields | Custom fields defined for contacts, with their slug and type.. | read-only |
create_custom_field | Define a new field for contacts (text, number, date or a list of options) so the bot and the team can store data about each person.. | writes |
Automations
| Tool | What it does | Access |
|---|---|---|
get_automation_usage | How many times each chatbot flow ran in the period, and which are active. | read-only |
list_automations | Automation flows of this organization: name, trigger, whether they are active and how many times they have run.. | read-only |
get_automation | Detail of a flow, including its node graph — useful to explain what the bot answers and where it escalates to a human.. | read-only |
set_automation_active | Enable or disable an automation flow. | writes |
list_broadcasts | Mass messaging campaigns sent or scheduled from the inbox, with their state.. | read-only |
list_sequences | Timed message sequences (drip campaigns) and their steps.. | read-only |
search_knowledge | Semantic search over everything this business has taught its AI: website, uploaded documents, social posts, manual notes. | read-only |
get_brand_profile | How this business describes itself and how its AI should sound: WHO SPEAKS (the company, a person or a character), business name, description, tone, agent name, standing instructions, which knowledge sources are loaded, and what it can DELIVER to a customer by DM. | read-only |
learn_brand_style | Re-reads the posts this workspace's accounts have already published and updates the posting style returned by get_brand_profile: brand colours with their role, how the posts are built, and how the brand writes on each network. | writes |
list_catalog | Catalogue of products/services this business has loaded, with price and description. | read-only |
get_automation_node_types | The FULL specification of every node and trigger a flow can use: what each one does, its exact fields with types and accepted values, its outputs (which branch goes where), and whether the chosen accounts support it. | read-only |
list_automation_templates | Ready-made flows (welcome menu, lead capture, qualify and hand off, follower gate, comment coupon, drip opt-in), each with the COMPLETE graph it would build and the trigger it would use. | read-only |
create_automation_from_template | Instantiate a template as a new flow, adapted to this business. | writes |
create_automation | Create a chatbot flow. | writes |
update_automation | Edit a flow: name, trigger, target accounts or the whole node graph. | writes |
duplicate_automation | Copy an existing flow, graph and all, so you only have to change what differs — typically the keyword and the post. | writes |
delete_automation | Delete a flow permanently. | destructive |
create_broadcast | Create a mass message to the CRM contacts of one account. | destructive |
send_broadcast | Send a broadcast NOW to every recipient. | destructive |
cancel_broadcast | Cancel a scheduled broadcast, or delete it entirely with remove: true.. | destructive |
create_sequence | Create a timed message sequence (drip): each step goes out after its delay. | writes |
update_sequence | Change the state of a drip sequence.. | writes |
enroll_in_sequence | Enroll a SEGMENT of contacts in a drip sequence: those carrying the given tags, or every subscriber of that account if no tag is given. | destructive |
teach_knowledge | Add text to this workspace's knowledge base: a policy, an FAQ, prices, how a process works. | writes |
manage_catalog | Maintain the product/service catalogue the assistant shows customers. | writes |
list_quick_automations | The simple automations built without the flow editor: someone comments a keyword and gets a direct message, or replies to a story and the bot answers.. | read-only |
get_bot_setup | Persistent menu (Facebook), ice breakers (Instagram) and bot commands (Telegram) configured on an account. | read-only |
set_bot_starters | Configure what a customer sees before writing: the persistent menu on Facebook (up to 3 entries) or the ice breakers on Instagram (up to 4 questions). | writes |
get_brand_sentiment | INFERNO ONLY. | read-only |
get_brand_memory | The lasting rules the owner has set for this workspace's content — whoever speaks there: a brand, a person or a character (see speaker in get_brand_profile) — target audience, content tone, preferred call to action and comment keyword, visual direction, positioning, things to never say, terminology, offers, goals, content preferences — each with where it came from. | read-only |
remember_brand_fact | Save ONE lasting rule the owner stated for this workspace's content — whether it speaks as a brand, a person or a character (e.g. | writes |
forget_brand_fact | Delete one brand rule from this workspace by its id (from get_brand_memory). | destructive |
Analytics and listening
| Tool | What it does | Access |
|---|---|---|
get_analytics | Aggregated performance for the period: totals per metric (impressions, reach, likes, comments, shares, saves, followers…), the same totals for the previous period so you can state growth, and a per-network breakdown. | read-only |
get_best_times | Weekday × hour engagement grid built from this organization's own history, in its timezone. | read-only |
get_follower_growth | Follower evolution per account and in total, from the daily snapshots Ignix stores. | read-only |
get_engagement_trend | Daily engagement and impressions over the period, plus whether the second half is doing better or worse than the first. | read-only |
get_audience | Audience breakdown by age, gender, country and city. | read-only |
get_inbox_analytics | Messaging performance: messages received and sent, share answered by automation, average and median response time, unread count, and the busiest accounts.. | read-only |
manage_saved_searches | INFERNO ONLY. | writes |
search_reddit | Search Reddit, or read the feed of a subreddit, through a connected Reddit account. | read-only |
build_report_link | Link to the analytics report laid out as a document — cover, executive summary and one section per page — ready to save as PDF from the browser. | read-only |
get_x_usage | X is the only network billed per use, so X actions spend from a monthly pool of Ignix credits (1 credit = 1 cent): every connected X account brings a free allowance (from Blaze), X seats add more, and when the pool is empty EVERYTHING on X that costs credits pauses until next month or a new seat — posting, links, DMs, listening and comment automations. | read-only |
Google Business, WhatsApp and web chat
| Tool | What it does | Access |
|---|---|---|
list_whatsapp_templates | Message templates approved by WhatsApp for an account, with their status. | read-only |
manage_reputation_alerts | Read or change the reputation rules: the warning that fires when negative messages spike above the usual daily average, and what happens when a new review arrives — alert the team at or below a star rating, and optionally reply automatically at or above one. | writes |
manage_whatsapp_templates | Message templates are what WhatsApp requires to write to someone outside the 24h window, and Meta has to approve them first — a new one starts as PENDING and cannot be used until it is APPROVED. | writes |
manage_whatsapp_profile | The business card customers see on WhatsApp: the "about" line, description, email, websites, address and business vertical.. | writes |
manage_whatsapp_flows | Flows are the forms that open inside WhatsApp (booking, qualifying, ordering). | writes |
get_gbp_listing | Everything on the business listing: its locations, the details (description, website, phone), the attributes Google offers for that category, the services, the booking/order links and the food menu. | read-only |
update_gbp_listing | Change the description, website or phone, and switch on or off the boolean attributes Google offers for that category (wheelchair access, outdoor seating, delivery…). | writes |
manage_gbp_photos | The photos on the listing. | writes |
manage_gbp_offerings | What the business sells and how people act on it: the service list, the action links (book, order, reserve) and the food menu. | writes |
manage_gbp_verification | An unverified listing does not show up properly in Search or Maps, so this is usually the first thing to fix. | writes |
manage_web_chat | The chat bubble the customer embeds on their own website. | writes |
Team
| Tool | What it does | Access |
|---|---|---|
get_connect_url | Return a link the human can open to connect a new social account, or to reconnect one whose token expired. | writes |
list_writing_assets | Hashtag sets and reusable text snippets the team has saved. | read-only |
save_writing_asset | Store a reusable hashtag set or text snippet so the team (and future posts) can use it.. | writes |
engage_on_x | Act on X (Twitter) from a connected account: retweet a post, bookmark it, or follow an account. | destructive |
list_team | Who is in this organization, with their role, plus the sub-teams and the pending invitations. | read-only |
Everything else
| Tool | What it does | Access |
|---|---|---|
manage_style_examples | Style material the customer SUPPLIES from accounts that are not connected to Ignix: captions, video transcripts or images from their old TikTok, another brand of theirs, anything they want the style learned from. | writes |