Connect your AI tools to Spoks using the Model Context Protocol (MCP), an open standard that lets AI assistants interact with your Spoks workspace.

What is Spoks MCP?

Spoks MCP is Spoks' hosted MCP server that gives AI tools secure access to your store including campaigns, flows, contacts, segments, forms, media, products, and discounts. It's designed to work with popular AI assistants like Claude, ChatGPT, and more.

Why use Spoks MCP?

Easy setup — Connect through OAuth by logging in with your Spoks account; there are no keys to manage.
Natural-language marketing — Draft campaigns, build audiences, and read performance stats in conversation instead of clicking through the app.
On-brand by default — Your AI assistant can read your store's branding and recent campaigns so the copy it drafts matches your voice.
Ecommerce-aware — Pull in real Shopify products and discount codes so content references actual prices, images, and offers.
Safe by design — The MCP is read-mostly. The only changes it can make are draft campaigns, segments, and media uploads. It can't send, schedule, activate, change settings, edit contacts, or delete anything.
Works within your access — It connects as you, only reaches stores you belong to, and respects what your role allows.

What can you do with Spoks MCP?

Draft campaigns — Create and edit draft emails and SMS, update individual content blocks, and get a link to open the draft in the editor.
Target the right audience — Search contacts, look up a single contact's profile and activity, preview a filter's reach, and create or update saved segments.
Review your flows — List automated flows and read their steps, and edit posts inside a flow that isn't live yet.
Measure performance — Pull delivery and performance stats for campaigns: recipients, clicks, attributed revenue, and purchases.
Reuse your content — Search your media library and upload new images, and find signup forms and polls to drop into content.
Bring in your store — Search Shopify products and discounts to feature real items and offers.

Getting started

Prerequisites

Before connecting Spoks MCP, make sure you have:

An active Spoks store.
An MCP-compatible AI client such as Claude Desktop, Claude.ai, ChatGPT, or Cursor.

Connecting to Spoks MCP

Add Spoks as a remote MCP server using this endpoint:

https://mcp.spoks.com/mcp

You authenticate with OAuth by logging in with your existing Spoks account; there are no keys to manage, and access follows your account.

Steps to connect can differ between clients, but here are a few examples:

For Claude Desktop or Claude.ai:

Open Customize → Connectors → Add custom connector.
Add a connector name, e.g. "Spoks".
Paste https://mcp.spoks.com/mcp.
Complete the Spoks login when prompted and approve access for Claude.

For ChatGPT:

Navigate to Settings → Connectors.
In Advanced settings, toggle Developer mode on.
Click Create connector.
Add a name, e.g. "Spoks".
Paste https://mcp.spoks.com/mcp.
Select OAuth as authentication.
Review permissions and approve.

Others: Add https://mcp.spoks.com/mcp as a remote MCP server and complete the OAuth authentication when prompted.

Choosing a store

If you have more than one store, your AI assistant picks the store for each request. Start a conversation by asking which stores you can access, then tell it which one to work in. You can switch stores at any point in the conversation.

Supported tools

Once connected, your AI assistant can use these tools to search, read, draft, and organize content in your store. The real power comes from combining them — a single request can look up a segment, preview its size, draft a campaign for it, and hand back an editor link.

Identity & store

Tool	Description	Example prompts
`whoami`	Shows who you're connected as and which stores you can access, plus context for the current store — timezone, plan, connected Shopify store, send counts, and SMS credits.	"Which stores do I have access to?" / "What plan and timezone is this store on?"
`get_settings`	Returns your store's branding and content defaults: colors, fonts, logo, footer, locale, sender name, and announcement bar.	"What are our brand colors and sender name?" / "Show me the footer and social links"
`get_links`	Returns links into the app for things the MCP can't do for you — sender identity, domain, activating a flow, sending a campaign, and team management.	"How do I send this campaign?" / "Where do I activate this flow?"

Campaigns

Tool	Description	Example prompts
`search_campaigns`	Finds campaigns by status, channel, or publish date — or searches your published campaigns by describing the tone or topic you want.	"List the last 10 published campaigns" / "Find a campaign with a warm welcome tone"
`get_campaign`	Opens a single campaign to show its content blocks and details.	"Show me the blocks in this campaign" / "Open campaign abc123 so I can edit it"
`get_campaign_statistics`	Shows how one or more campaigns performed: email and SMS recipients, clicks, attributed revenue, and purchases.	"How did last week's campaign perform?" / "Compare clicks across these three campaigns"
`draft_campaign`	Creates a new draft campaign and returns a link to open it in the editor.	"Draft a spring sale campaign" / "Create a welcome email introducing our new collection"
`update_draft_campaign`	Edits a draft — change the subject, rewrite content, or add, remove, and reorder blocks. Also works on a post in a flow that isn't live yet.	"Change the subject line on this draft" / "Reorder the blocks: image first, then text"
`update_draft_campaign_block`	Updates a single block in a draft, leaving the rest untouched.	"Just update the hero image on this draft" / "Rewrite the body text block"

Flows

Tool	Description	Example prompts
`get_flows`	Lists your automated flows with their name, whether they're live, and connected posts.	"What flows do we have set up?" / "Which flows are live?"
`get_flow`	Opens a single flow to show all of its steps and details.	"Show me the steps in the welcome flow"

To edit a campaign inside a flow, the flow must be paused with no contacts currently enrolled.

Contacts & segments

Tool	Description	Example prompts
`search_contacts`	Searches your contacts by filters such as tags, activity, and sign-up date, and returns a count and summary list.	"How many contacts joined in the last 30 days?" / "Find contacts tagged VIP"
`get_contact`	Shows the full profile and recent activity for one contact, by email or ID. Personal details like addresses and notes are left out for privacy.	"Show me everything about [email protected]" / "What's this contact's recent activity?"
`get_segments`	Lists your segments, each with its filter and current size, so you can see reach at a glance.	"What segments do we have and how big are they?"
`get_segment`	Opens a single segment to show its filter, current size, and a few example contacts.	"Show me the active-buyers segment and a few example contacts"
`preview_segment`	Tries out a filter without saving it, returning how many contacts match and a small sample.	"How many contacts would match: tagged 'newsletter' and active in 90 days?"
`create_segment`	Saves a new segment from a filter and returns its size and a link to open it.	"Save that filter as a segment called 'Recent VIPs'"
`update_segment`	Updates a segment's name, filter, description, or emoji. If draft or scheduled campaigns already use it, Spoks warns you before applying the change.	"Broaden the VIP segment to include contacts active in 180 days"

Forms & media

Tool	Description	Example prompts
`search_forms`	Finds your signup forms and polls, with their status and submission counts, to reference in content.	"List our active signup forms" / "Find the poll about product preferences"
`search_media`	Searches your media library for images and videos to use in content.	"Find the logo image" / "Show images uploaded in the last month"
`upload_media`	Adds images to your media library by URL (up to 10 at a time) so you can use them in content.	"Upload this image: https://… and name it 'summer-hero'"

Ecommerce

Tool	Description	Example prompts
`products_search`	Searches the products in your connected Shopify store, returning real titles, prices, and images to feature.	"Find products under $50 that are in stock" / "Show our newest items"
`discounts_search`	Searches your discounts, returning codes, amounts, usage limits, and validity windows.	"List active discount codes" / "Find the personalized 20%-off codes"

Sample prompts

Campaign drafting

Prompt	What it does
"Draft a campaign announcing our spring collection"	Creates a draft campaign and returns an editor link
"Match our brand voice and rewrite the intro on this draft"	Reads your settings, then updates a single block on the draft
"Reorder the blocks so the image comes first"	Updates the draft's block order

Audience & segments

Prompt	What it does
"How many contacts joined in the last 30 days?"	Runs a filtered contact search and returns the count
"Preview an audience of contacts tagged VIP and active in 90 days"	Previews a filter's reach without saving it
"Save that as a segment called 'Recent VIPs'"	Saves the filter as a segment and returns a link

Performance

Prompt	What it does
"How did last week's campaigns perform?"	Finds the campaigns and pulls their stats
"Which campaign drove the most attributed revenue?"	Compares performance across campaigns

Flows

Prompt	What it does
"What flows do we have and are any live?"	Lists your flows and their status
"Edit the second step of the welcome flow"	Opens the flow, then edits the post (the flow must be paused)

Ecommerce

Prompt	What it does
"Draft a campaign featuring our 3 newest products"	Looks up real product details, then drafts the campaign
"List our active discount codes"	Searches your discounts

Rate limits

Spoks MCP applies a single rate limit per user, shared across all tools:

Limit	Scope	Applies to
20 requests / 60 seconds	Per user	All tools (shared)

If you reach the limit, you'll see a message telling you how many seconds to wait. Pausing for that window and spreading requests out keeps you under the limit. Normal back-and-forth in a chat rarely gets close.

Security best practices

Authentication

Spoks MCP uses OAuth authentication, meaning:

You log in with your Spoks credentials.
You don't need to manage API keys.
Access is determined by your Spoks permissions.

Approval flows

Read and write tools are labeled properly so you can manage which tools to auto approve and which should need manual approval before usage.

Data access

Spoks MCP works only within stores you belong to, with the same access your Spoks account already has.
Contact personal data is treated as sensitive: addresses and notes are left out of contact results, and the tools are geared toward aggregate answers rather than listing individuals.

Getting help

If something isn't working for your account or store, reach out to the Spoks team from the in-app support chat.