Logo

MCP Tools Reference

A complete reference of every tool the Quotient MCP server exposes, grouped by area — campaigns, email, social, audience, and more.

These are the tools available once you've connected to the Quotient MCP server. New to MCP? Start with the overview, or see the setup instructions to connect your app.

Each tool lists the permission it needs in parentheses. Read tools only fetch data; write tools can create or update data.

Agent (A2A)

Send messages to Quotient and collect its replies — useful for tasks the dedicated tools don't cover, like authoring emails.

  • a2a-send-message: Send a message to Quotient to start a new conversation or continue an existing one.
  • a2a-get-response: Collect Quotient's reply to a previously sent message.

Memory

Quotient's persistent memory, organized into folders. (Requires MEMORY_READ / MEMORY_WRITE.)

  • memory-cat: Read one or more memories by path. Returns each memory's content as a separate part.
  • memory-ls: List the folders and memories directly inside a folder, one page at a time.
  • memory-search: Search across all memories by meaning to find the most relevant sections.
  • memory-write: Write or update a memory at a given path (content, tags, and/or pinned state).
  • memory-mkdir: Create a folder. Parent folders are auto-created.
  • memory-mv: Move or rename a memory or folder, including all of a folder's contents.
  • memory-rm: Remove a memory or folder. It's archived rather than permanently deleted, so it can be recovered.

Campaigns

Campaigns and their tasks. Briefs and task descriptions are written and returned as Markdown. (Requires CAMPAIGN_READ / CAMPAIGN_WRITE.)

  • create-campaign: Create a campaign from a name and a Markdown brief, optionally with initial tasks.
  • update-campaign: Update a campaign's name, brief, and/or dates (the brief replaces the entire brief).
  • get-campaign: Get a campaign by id — its brief as Markdown, plus its tasks and deliverables (blogs, posts, emails, documents).
  • list-campaigns: Browse campaigns, most recent start date first, one page at a time. Optionally filter by start-date range.
  • create-campaign-task: Create a task on a campaign.
  • update-campaign-task: Update a task's fields and/or status (the description replaces the entire description).
  • get-campaign-task: Get a campaign task by id — its fields and description as Markdown.
  • list-campaign-tasks: Browse campaign tasks, most recently updated first, one page at a time. Optionally filter by campaign and/or status.

Email

Read-only access to email broadcasts; broadcasts are created by asking Quotient directly (a2a-send-message). (Requires EMAIL_READ.)

  • get-email-broadcast: Get an email broadcast by id — name, status, launch date, target segments and lists, and a summary of the current email version.
  • list-email-broadcasts: List your email broadcasts, most recently updated first, one page at a time.

Analytics

Run reports over your marketing data — web traffic, email engagement, social performance, marketing events, and custom events — and manage saved reports. A report is a JSON query naming metrics, dimensions, and filters; read describe-report-catalog once before writing your first one. (Requires ANALYTICS_READ / ANALYTICS_WRITE.)

  • describe-report-catalog: The reference for writing report queries — the document shape, every metric and dimension with what it means and which pair together, filter and time rules, and worked examples.
  • run-report: Run a report query and get back a typed table, the resolved date windows, a CSV download link, and a run id. Nothing is saved.
  • get-report-rows: Page through the rows of a completed report run by run id.
  • create-report: Save a named report and run it now. The run becomes the report's snapshot. (Requires both ANALYTICS_READ and ANALYTICS_WRITE, since it returns the result.)
  • update-report: Update a saved report's name, query, or visualization. Query changes refresh the snapshot in the background.
  • get-report: Get a saved report by id — its query, visualization config, and current snapshot.
  • list-reports: Browse saved reports, one page at a time, optionally searching by name.
  • list-custom-events: List the custom event types defined for the business, with the ids to use in reports.
  • create-custom-event: Define a new custom event type. The event id is immutable once created.

Blog

Blog posts, written and returned as Markdown. (Requires BLOG_READ / BLOG_WRITE.)

  • create-blog: Create a blog post from a title and Markdown content (created as a draft).
  • update-blog: Update a blog post's title, content, meta description, and/or tags (content replaces the whole body).
  • get-blog: Get a blog post by id — content as Markdown, status, slug, meta description, and tags.
  • list-blogs: Browse blog posts, most recently updated first, one page at a time.
  • publish-blog: Publish a blog post immediately, or schedule it for a future date.
  • unpublish-blog: Revert a published or scheduled blog post back to a draft, taking it offline.

Social

Create, schedule, and publish social posts across X, LinkedIn, Instagram, Facebook, and TikTok. (Requires SOCIAL_READ / SOCIAL_WRITE.)

  • list-social-accounts: List your connected social accounts — id, platform, handle, and connection status.
  • create-social-post: Create a new social media post with platform-specific optimizations (created as a draft).
  • update-social-post: Update a draft post's content, attached assets, internal name, or platform-specific metadata.
  • get-social-post: Retrieve a post's full details — content, status, publish date, attached assets, and the live platform URL once published.
  • list-social-posts: Browse social posts, most recently created first, one page at a time.
  • search-social-posts: Search social posts by name, body copy, or related meaning, with optional platform, status, and campaign filters. Paged.
  • publish-social-post: Publish a social post immediately, or pass publishAt to schedule it for a future date.
  • unschedule-social-post: Return a scheduled post to a draft. No platform side effects.

Documents

Documents, written and returned as Markdown. (Requires DOCUMENT_READ / DOCUMENT_WRITE.)

  • create-document: Create a document from Markdown content.
  • update-document: Update a document's title and/or content (content replaces the whole document).
  • get-document: Get a document by id — its title and current content as Markdown.
  • list-documents: Browse your documents, most recently updated first, one page at a time.

Assets

Your media library. (Requires ASSET_READ / ASSET_WRITE.)

  • create-asset-from-url: Download an image or file from a public URL into the media library. Private or internal URLs are refused.
  • get-asset: Get a media asset's metadata and CDN link by id — name, type, size, dimensions, and status.
  • list-assets: Browse the media library, most recently updated first, one page at a time. Optionally filter by media type.
  • search-assets: Find media assets by a text query over their names and descriptions.

Audience (CRM)

People and companies can be created, read, updated, and listed; deals are read-only (synced from your connected CRM). (Requires the matching AUDIENCE_*_READ / AUDIENCE_*_WRITE scope.)

  • create-person: Create a person in your audience, identified by email address.
  • update-person: Update an existing person by id or email. Only provided fields change.
  • get-person: Get a person's full profile by id — contact fields, subscription status, engagement, company link, and custom properties.
  • list-people: Browse people, newest first, one page at a time. Optionally search and filter by subscription status.
  • create-company: Create a company in your audience (only the name is required).
  • update-company: Update an existing company by id. Only provided fields change.
  • get-company: Get a company's full profile by id — firmographics, location, social links, associated people and deals, and custom properties.
  • list-companies: Browse companies, name-ascending, one page at a time. Optionally search and filter by industry.
  • list-deals: Browse your deals, one page at a time, optionally filtered by status. Read-only — synced from the connected CRM.

Documentation

  • search-docs: Search the Quotient documentation for features, setup guides, and troubleshooting. Returns the most relevant pages with an excerpt each, one page at a time.
  • get-doc: Read the full content of a Quotient documentation page by its slug.

Next Up