https://mcp.sapt.ai/mcp
Every signed-in session gets the same tools, whichever workspace is active. A tool used in a workspace without the integration it needs (for example, Google Business Profile for reviews) says what is missing instead of failing silently.
listShops and getShop appear only for Sapt platform admins.Tools
Workspace and feedback
| Tool | What it does |
|---|---|
whoami | Who the connector is acting as, and which workspace is active. |
getProject | List the workspaces you can access, or read one in full. |
switchProject | Switch the active workspace for the rest of the session. |
submitFeedback | Report a platform issue to the Sapt team, or send a support request to the same queue as app.sapt.ai/support. |
getFeedback | Search known issues, or read one in full. |
listInquiries | List contact-form, funnel, and wholesale inquiries the project received. |
Context, memory, and branding
| Tool | What it does |
|---|---|
getProjectContext | The foundational context: brand voice, ICP, strategy, and a map of the project’s record types, workflows, numbers, mailboxes, and calendars. Call it first. |
getBranding | The visual brand identity: colors, fonts, logos, tagline, keywords, guidelines, and ready-made design tokens. |
updateBranding | Update the visual brand identity. Arrays (colors, fonts, keywords) replace the existing ones. |
getMemory | List memory entries, or read one in full. |
saveMemory | Create or update a memory entry, a markdown document keyed by slug. Replaces the whole document. |
renameMemory | Rename a memory entry’s key, keeping its content and history. |
deleteMemory | Delete a memory entry. brand, icp, strategy, and branding are protected. |
recall | Search memory by subject and get back snippets, cheaper than loading whole entries. |
getActionItems | What needs attention now and what ships soon: failed posts, unanswered reviews, scheduled sends and posts, pending inquiries. |
CRM and inbox
| Tool | What it does |
|---|---|
getObjectType | List the record types in this workspace, or read one type’s schema. |
createObjectType | Define a new record type with an initial schema. |
updateObjectType | Patch a record type’s schema or settings. The slug can’t change. |
deleteObjectType | Delete a record type and all its records. Dry run by default. |
getObjectRecord | List records of a type, or read one record. |
saveObjectRecord | Create or update a record, including its relations. |
deleteObjectRecord | Permanently delete a record. |
bulkDeleteObjectRecords | Preview or permanently delete the records of one type that match a filter. |
listRelatedRecords | List the records linked to a record through a named relation. |
createRelation | Declare a new relation between two record types. |
setRelationLabel | Rename the label on one side of a relation. |
deleteRelation | Delete a relation and every link made through it. |
listInboxConversations | The latest conversation per Person, newest first, with ad source, lead type, channel, and whether it needs a reply. |
listInboxFilterOptions | The channels, source record types, and repliers actually present in the inbox. |
getPersonJourney | One Person’s full timeline: web sessions, emails, texts, calls, DMs, orders, and lifecycle changes, with attribution. |
sendEmailToPerson | Send an email to a Person record. It checks the project can send first. |
Content and assets
| Tool | What it does |
|---|---|
getContentType | List content types, or read one with field-type docs. |
saveContentType | Create or update a content type’s schema. |
deleteContentType | Permanently delete a content type. It must have no items. |
getContentTypeUsageCount | Count the items under a content type, before you delete it. |
getContent | List content items, or read one in full. |
saveContent | Create or update a content item. |
deleteContent | Permanently delete a content item. |
listAssets | List the images, video, documents, and audio in the asset library. |
uploadImageFromUrl | Upload an image to the asset library from a URL. |
Website
| Tool | What it does |
|---|---|
website | The shop’s website: discover sections and forms, make private draft edits, set up forms and where they send, and verify a publish. |
Workflows and scheduled tasks
| Tool | What it does |
|---|---|
getWorkflow | List workflows, or read one with its trigger and actions. |
saveWorkflow | Create or update a workflow. A new workflow is saved inactive. |
setWorkflowActive | Turn a workflow on or off. |
deleteWorkflow | Permanently delete a workflow. |
listWorkflowRuns | Recent workflow runs, newest first, for debugging why something did or didn’t fire. |
listAgentTasks | List the project’s scheduled agent tasks. |
triggerAgentTask | Run a scheduled task now, outside its schedule. |
getAgentTaskRuns | A task’s run history: when it ran, whether it succeeded, and its output. |
Conversation assistants and booking
| Tool | What it does |
|---|---|
getConversationAssistants | Read the assistants that answer customers: their settings, connected numbers and mailboxes, calendars, and credit availability. |
saveConversationAssistant | Save an assistant’s full configuration, the same way the Inbox does. |
getConversationApprovals | Read a customer’s proposed replies and bookings waiting for review, queued sends, and uncertain outcomes. |
resolveConversationApproval | Approve or dismiss a reviewed reply or booking. |
setConversationActionPolicy | Set the project-wide ceiling for what assistants may do automatically. |
getConversationUsage | The project’s credit usage for the last 30 days, by category. |
bookAppointment | Book a customer on the shop’s schedule once a person has agreed the time with them. |
Outreach
| Tool | What it does |
|---|---|
previewOutreachAudience | Preview the personalization for an outreach workflow’s audience without enrolling anyone or sending email. |
enrollOutreachAudience | Start the outreach workflow for a CRM List or chosen People. Real emails begin sending, paced by mailbox caps and send windows. |
Email campaigns
| Tool | What it does |
|---|---|
getTemplate | List email templates, or read one in full. |
createOrUpdateTemplate | Create an email template, or update one. |
previewEmail | Render a template as HTML, or send a test to one to three inboxes. |
scheduleEmailCampaign | Send an email campaign to a recipient list now or at a set time. |
listScheduledCampaigns | List pending scheduled email sends. |
cancelScheduledCampaign | Cancel a scheduled send before it goes out. |
Texting
| Tool | What it does |
|---|---|
requestTextingRegistration | Ask Sapt to register the workspace’s own texting brand and campaign (US 10DLC) with the carriers. |
getTextingRegistration | Where that registration stands, plus what the carrier reports for the line today. |
Integrations, credentials, and webhooks
| Tool | What it does |
|---|---|
listIntegrations | Every known integration provider, with this workspace’s connection status. |
connectIntegration | Connect an API-key provider in one step and get back the webhook URL to paste into the provider. OAuth providers connect in the app. |
disconnectIntegration | Disconnect a provider: deletes its stored credentials and webhook settings. |
testIntegration | Make a test call to the provider with the stored credentials. |
listCredentials | List stored credentials: names and metadata only, never values. |
saveCredential | Store (or overwrite) a custom credential by name. |
deleteCredential | Deactivate or delete a credential. |
listInboundWebhooks | List the custom inbound webhook sources set up in this workspace. |
saveInboundWebhook | Set up (or overwrite) an inbound webhook for a custom source. |
deleteInboundWebhook | Deactivate or delete an inbound webhook. |
configureIdentityResolution | Turn on an identity resolver (People Data Labs, Versium, Enrow, BigDBM, RB2B, or a generic HTTP endpoint). |
Social planning and engagement
| Tool | What it does |
|---|---|
context | Everything needed to plan social posts and ads in one read. Call it first. |
save | Create or update posts and ads, several at once. Nothing publishes here. |
schedule | Send saved posts to their accounts and put ads into Meta ad sets. |
items | Where every post and ad stands: drafts, scheduled, publishing, published, failed, with errors and links. |
research | What is winning on the Instagram and YouTube accounts this workspace watches, scored against each account’s usual post. |
getEngagement | An account’s recent comments and DMs. Comments work on Instagram, Facebook, TikTok, and YouTube; DMs on Instagram and Facebook. |
respondToMessage | Reply to comments and DMs, and moderate comments. |
Ads
| Tool | What it does |
|---|---|
getAdsLandscape | Read ads structure, performance, or competitor research in one tool. |
getAdsInsights | Diagnostics: fatigue, disapprovals, baselines, top and under-performers, and significance checks. |
manageAdEntity | Pause, resume, update, or duplicate a campaign, ad set, or ad. The project’s action policy decides whether it runs now or waits for approval. |
getAdReviewStatus | An ad’s Meta review status and per-placement disapproval reasons. |
launchAds | Launch a campaign, ad set, and ads from a brief. Everything is created paused. |
getAdExperimentResults | Pick a winning ad only when the result is statistically significant and every variant has enough data. |
setAdAutomationRule | Create a scheduled rule that pauses underperforming ads. |
deleteAd | Delete one ad draft in Sapt. Meta ads already created from it keep running. |
Analytics
| Tool | What it does |
|---|---|
getLeadLedger | The raw conversion events behind Performance lead and purchase totals, with stitched identity and first-touch source. |
getInboxMetrics | What the inbox did over a recent window: contacted, replied, reply rate, spoken with, and median minutes to first reply. |
getWebAnalytics | Search Console and GA4 data in one tool. |
getFirstPartyAnalytics | Sapt’s own tracking: pageviews, events, referrers, devices, scroll depth, outbound clicks, and live visitors. |
getSocialAnalytics | 30-day account metrics and recent posts for Instagram, Facebook, TikTok, and YouTube. |
getEmailAnalytics | Email marketing totals, rates, daily series, template comparison, and device and country breakdowns. |
Google Business Profile
| Tool | What it does |
|---|---|
getGbpStatus | The Google Business Profile connection and every linked location. |
listReviews | A location’s reviews, with ratings, comments, dates, and existing replies. |
replyToReview | Post or update a reply to a review. The reply is public on Google. |
getBusinessHours | A location’s current business hours. |
Clips and video
| Tool | What it does |
|---|---|
clips | Turn footage into captioned vertical clips and put the good ones in the posting queue. |
longform | Long-form YouTube videos for a persona or brand, from idea to measured. |
channels | Prepare YouTube channel briefs, then verify each connected channel as its own posting identity. |
campaigns | Find, inspect, and save Content Rewards campaign briefs. |
submissions | The Content Rewards submission desk: prepare, send, and reconcile submissions, and connect the account. |
campaignPost | Check, publish, and submit one reviewed campaign post. |
operations | The clipping portfolio: connected accounts, cadences, scheduled totals, render states, and publish failures. |
Shops (platform admins only)
| Tool | What it does |
|---|---|
listShops | Every shop Sapt is onboarding or running, flagged shops first. |
getShop | One shop in full, with its checklist, seven-day health, texting registration, and search clicks. |