get_action_outcome_history | Returns recent Citable-emitted actions for the brand, with their measured outcome deltas where the measurement window has resolved. | Read only |
get_action_with_children | Returns a parent action ticket and all its child content tickets (drafts, scheduled, posted) in one call. | Read only |
get_ae_project | Returns ONE Action Engine project: its goal, verifiable metrics, evidence, and — when the project is live — its ticket list. | Read only |
get_ae_projects | Returns the brand’s Action Engine PROJECTS (campaigns), grouped by initiative, each with its ticket rollup. | Read only |
get_attribution_report | Returns AI-citation attribution for posted content. | Read only |
get_brand_context | Returns the brand’s identity snapshot — id, slug, plan tier, name, mission/description, industry, differentiators, personas (every active one), distribution accounts per channel… | Read only |
get_brand_visibility | Returns the brand’s AI visibility summary from the AI assistants listed in engines, each with the date of its last answer. | Read only |
get_content_body | Returns the full body text of one content item, plus its title, SEO metadata, and status. | Read only |
get_content_performance | Lists the brand’s posted content (anything generated in Citable with a posted_url) with GA4 traffic per page: sessions, pageViews and users (GA4 “Users”, activeUsers) over the t… | Read only |
get_geo_priorities | Returns the brand’s top-priority AI visibility tickets from the Citable Action Engine, ordered by time_group (today → this-week → next-week → backlog). | Read only |
get_paid_ads_insights | Returns the 4-card funnel (Citation Rate, Mention Rate, Average Rank, Sentiment) plus paid metrics (impressions, clicks, spend, CPC, CTR) for the brand’s paid placements on AI e… | Read only |
get_pdp_publish_readiness | Checks whether this brand can publish PDP changes to live Shopify right now (connection, write scopes, SHOPIFY_LIVE_WRITE_ENABLED). | Read only |
get_pdp_run | Returns one PDP optimization run and its change proposals (diffs, decisions, write status). | Read only |
get_search_console | Returns Google search demand from the brand’s connected Google Search Console: the Google search queries the brand’s pages showed for, and the pages themselves, with googleImpre… | Read only |
get_top_products | Returns the brand’s best-selling Shopify products, ranked by units sold and filtered to real merchandise (excludes non-product line items like shipping insurance). | Read only |
get_topical_authority | Returns the brand’s topical authority matrix — Citation Rate, Mention Rate, Average Rank, and Sentiment broken down per competitor — filterable by journey stage, persona, and AI… | Read only |
list_brands | Returns the one brand this call is authorized for. | Read only |
list_content | Lists content rows for the brand with optional filters. | Read only |
list_open_items | Lists what on the brand is waiting on a person: posts scheduled but not posted, open Action Engine tickets with a due date, and product-page changes waiting for a decision. | Read only |
list_replies | Lists social-listening replies for the current brand. | Read only |
next_actions | Returns what to work on next for this brand: the open gaps (questions buyers are likely to ask where AI assistants don’t name the brand yet, with the questions’ ids and text), t… | Read only |
ping | Health check — returns the Citable MCP server identity and the resolved brand/user context. | Read only |
plan_question_bank | Call this first when the user wants to plan, rebuild, or expand the questions Citable tracks in AI search — or to see how many slots they have left. | Read only |
recommend_paid_ad_strategy | Proposes one ChatGPT Ads campaign test for the brand, built around its tracked questions, and lists what to test next. | Read only |
score_content | Scores a piece of content for GEO (how likely AI answer engines — ChatGPT, Perplexity, Google AI Overviews — are to CITE it) and returns an explainable, channel-aware breakdown … | Read only |
search_prompt_intelligence | Semantic search over the brand’s tracked prompts in Citable’s Prompt Intelligence system. | Read only |
suggest_broadcast | Suggests other platforms where the brand could broadcast a piece of existing content. | Read only |
approve_ticket | Marks a Citable GEO ticket as done. | Read, write and spend |
archive_prompts | Archive (or restore) tracked questions by id. | Read, write and spend |
cancel_content | Cancels a content draft: sets its status to cancelled, so it leaves the drafts backlog and the calendar. | Drafts for my approval |
complete_ae_project_ticket | Sets the status of a ticket that belongs to an Action Engine project. | Read, write and spend |
create_content_draft | Creates a content draft against an action ticket OR an ingested conversation. | Drafts for my approval |
decide_pdp_proposal | Approves, rejects, or resets ONE PDP change proposal. | Read, write and spend |
dismiss_ticket | Cancels a Citable GEO ticket with a required written reason. | Read, write and spend |
emit_content | Emit a piece of content for the brand: validates it against the target persona’s guardrails, saves a draft at status=‘queued’, and records the action so its citation / share-of-… | Drafts for my approval |
emit_operational | Emit an operational recommendation (config / setup change): records the action and adds a recommendation card to the Action Engine for review. | Drafts for my approval |
emit_outreach | Emit an outreach action: validates it against the persona’s guardrails, creates/updates the outreach reply, and records the action for later outcome measurement. | Read, write and spend |
emit_paid | Emit a paid ad on an AI surface (ChatGPT Ads today; Perplexity / Gemini / Grok / Copilot when those engines become available). | Read, write and spend |
emit_technical | Emit a technical recommendation against a specific URL: adds a recommendation card to the brand’s Action Engine and records the action for outcome measurement over time. | Drafts for my approval |
import_prompts | Import tracked questions into the brand’s question bank (additive — never modifies or removes existing questions). | Read, write and spend |
ingest_conversation | Pushes a conversation summary + extracted facts into the user’s Citable brand knowledge base. | Read, write and spend |
manage_paid_ad | Create or update a paid ad on an AI surface (ChatGPT Ads today; Perplexity / Gemini / Grok / Copilot when they ship). | Read, write and spend |
mark_content_posted | Records that a content draft has been posted by stamping the live URL and marking status=‘published’. | Read, write and spend |
mark_content_unposted | Records that posted content has been taken down: sets status=‘taken_down’ and unposted_at, and keeps posted_url and posted_at so the history survives. | Read, write and spend |
mark_reply_posted | Marks a social reply as posted with the live URL. | Read, write and spend |
publish_pdp_changes | Publishes ALREADY-APPROVED PDP proposals on a run to the live Shopify storefront. | Read, write and spend |
revert_pdp_run | Rolls every successfully written proposal on a PDP run back to its baseline_snapshot on live Shopify. | Read, write and spend |
schedule_content | Schedules a content draft onto the content calendar by setting scheduled_for, OR clears the schedule (when scheduled_for is null) to take it off the calendar. | Read, write and spend |
schedule_reply | Schedules a social reply onto the content calendar by setting scheduled_for, OR clears the schedule (when scheduled_for is null) to take it off the calendar. | Read, write and spend |
start_pdp_optimization | Proposes field-level changes to this brand’s Shopify product pages (PDPs) for a person to approve. | Drafts for my approval |
update_reply | Updates a draft social-listening reply (Reddit, Hacker News, future Twitter/LinkedIn). | Read, write and spend |