What AI apps can do in Pointerly (MCP tools)
Every action a connected AI app such as Claude or Codex can take in your workspace, by module: what it only looks up, what it changes, and what always waits for your approval.
What AI apps can do in Pointerly
When you connect an AI app such as Claude or Codex to Pointerly, it works through a fixed set of actions (MCP tools). This page lists all 232 of them by module, so you know what you are allowing when you tick a module during connection. To connect an app, see Connected apps.
Before you start
- The app only sees the modules and actions you ticked, in the one workspace you chose. It can never do more than you can do yourself.
- Looks up actions only read. Changes, Publishes, Sends and Deletes actions change something, and follow the mode you picked for that module: read only, with approval, or automatic with limits.
- Actions marked Always needs your approval wait for you in Pointerly in every mode. You approve or reject them in Pointerly, not in the AI app.
- Writes with AI actions generate text and use AI credits (unless your workspace uses its own AI key). They follow the module mode too.
- Every connection can also ask which account and workspace it is connected to, and what it may do there (
pointerly_whoami). That needs no permission.
Server address for apps that ask for it: https://mcp.pointerly.io/mcp.
Modules at a glance
| Module | What the AI can do | Looks up | Changes, sends or writes with AI |
|---|---|---|---|
| Links | Find your links and their stats, create new tracked links, and edit, pause or delete existing ones. | 5 | 9 |
| Link Collections | 2 | 3 | |
| QR Codes | 1 | 1 | |
| Bio pages | See your bio pages and their sections, and add one of your links to a page. | 4 | 15 |
| Affiliate tags | See your tracking IDs, create and edit them, check what deleting one would affect, and delete one. | 4 | 3 |
| Reports | Read totals and daily numbers from the store reports you imported, and see which report files are imported. | 3 | 0 |
| Analytics | 3 | 0 | |
| Earnings | 1 | 0 | |
| AI Content | Write posts, video scripts and other content with AI (uses AI credits), edit drafts, and publish or schedule them to your connected accounts. | 4 | 8 |
| Content Studio | See your connected social accounts, publishing queue and library, publish or schedule files from your library, retry or cancel publications, and write captions with AI. | 4 | 6 |
| DM automations | See, create, edit and delete your Instagram and Facebook DM automations and templates, switch automations on or off, check their activity, and resend failed DMs. | 13 | 12 |
| Telegram | See your channels, posts and templates, write drafts, and publish, schedule, move or cancel posts. | 3 | 11 |
| See your WhatsApp numbers, subscribers, topics, templates and broadcasts, manage topics and subscribe words, and create, send, schedule or stop broadcasts. | 14 | 20 | |
| Campaigns | See your brand campaigns and the marketplace, read a campaign brief, and create a campaign as a draft. | 3 | 1 |
| Campaign applications | See applications to your campaigns or your own applications as a creator, apply to a campaign, and withdraw an application. | 3 | 2 |
| Integrations | 3 | 1 | |
| Export | 0 | 1 | |
| Automations | See your automations and their runs, run one now, and switch one on or off. | 7 | 7 |
| Deals | 7 | 2 | |
| Help center | 1 | 0 | |
| Support | 3 | 2 | |
| Collaborations | 10 | 18 | |
| Inbox | 5 | 6 |
Links
Find your links and their stats, create new tracked links, and edit, pause or delete existing ones.
| Tool | Type | What it does |
|---|---|---|
links_list | Looks up | Lists your links, newest first by default, with the total for paging. |
links_get | Looks up | Gets one link by its public id ("lnk_…", from links_list): destination URL, short URL, product, affiliate tag, status, expiry, clicks and conversions. |
links_create | Changes | Creates a tracked short link for a product URL (Amazon, Walmart or any https store) and returns it with its short URL. |
links_update | Changes | Changes one existing link (id from links_list) and returns it: slug, title, affiliate tag, pause or resume, shop visibility, pin or expiry. |
links_delete | Deletes | Deletes one link permanently (to stop it for a while, pause it with links_update). Always needs your approval. |
links_import_amazon_preview | Looks up | Reads an Amazon idea list or a whole storefront without creating anything, so you can review it before links_import_amazon. |
links_import_amazon | Changes | Imports the products of an Amazon idea list, or of every list on a storefront, as tracked links. |
links_import_jobs_get | Looks up | Gets an Amazon import job started by links_import_amazon: its status, lists done out of the total, and per list the links created, reused or skipped, its folder and bundle, and any error. |
links_find_existing | Looks up | Finds your links for a product before creating one: pass the product URL (or an Amazon ASIN). |
links_refresh_metadata | Changes | Re-reads one link's product data from its store (id from links_list) and saves what changed: title, image, brand, store and, for price, the current price (Amazon, eBay and Walmart products). |
links_check_health | Changes | Checks one link against its store now (id from links_list): is the product still sold, in stock, and does the destination carry the right affiliate tag. |
links_bulk_update_status | Changes | Pauses or resumes several links at once (ids from links_list). |
links_bulk_delete | Deletes | Deletes several links permanently (ids from links_list); use only when you asks to delete them. Always needs your approval. |
deals_create_link | Changes | Creates a tracked short link to a deal's product (deal id from any deals tool), with the deal's title and image and your affiliate tag for the store, and returns it like links_create. |
Link Collections
| Tool | Type | What it does |
|---|---|---|
link_collections_list | Looks up | Lists your link bundles, most recently changed first. |
link_collections_get | Looks up | Gets one link bundle (id from link_collections_list): title, status, public shareUrl, views and its links in page order with their short URLs. |
link_collections_create | Changes | Creates a link bundle from 2 to 100 of your links (ids from links_list) and returns it with its public shareUrl: one page that lists the products, each clicked through its own short link. |
link_collections_update | Changes | Changes one link bundle (id from link_collections_list) and returns it: title, description, cover, pause or resume its public page, and its links. |
link_collections_delete | Deletes | Deletes one link bundle (id from link_collections_list); use only when you asks to. Always needs your approval. |
QR Codes
| Tool | Type | What it does |
|---|---|---|
qr_codes_list | Looks up | Lists your dynamic QR codes, newest first, with their scan counts and image URLs. |
qr_codes_create | Changes | Creates a dynamic QR code that opens one of your links (id from links_list) and returns its scan URL and print-ready image URLs. |
Bio pages
See your bio pages and their sections, and add one of your links to a page.
| Tool | Type | What it does |
|---|---|---|
bio_pages_list | Looks up | Lists your bio pages: public id ("bio_…"), slug, title, public URL, views, link clicks, and whether each is published or the default. |
bio_pages_get | Looks up | Gets one bio page by public id ("bio_…") or slug, with its sections (id, type, title, order, visibility, link count). |
bio_add_link | Changes | Adds an existing link to a links or highlights section of a bio page, at the top or bottom. |
bio_sections_list | Looks up | Lists every section of one bio page in page order: id, type, title, visibility, its settings (config, by type) and, for links and highlights sections, the links in it (items and groups). |
bio_sections_get | Looks up | Gets one bio page section by id (from bio_sections_list): type, title, visibility, its settings (config) and, for links and highlights sections, its links and groups. |
bio_sections_create | Changes | Adds a section at the bottom of a bio page and returns it. |
bio_sections_update | Changes | Changes one section (id from bio_sections_list) and returns it: its name in the editor, whether it shows on the page, and its settings (config, whose type must be the section's type; only the fields passed change, its links and styles stay). |
bio_sections_reorder | Changes | Puts the sections of one bio page in a new order and returns the full order. |
bio_sections_delete | Deletes | Deletes one section from a bio page for good, with its settings and the list of links shown in it (the links stay in the workspace). Always needs your approval. |
bio_theme_generate | Changes | Designs a bio page theme with AI from a short description ("dark and minimal", "pastel summer", "ocean vibes") and returns its name and style values (colors as hex, font, card and button styles). |
bio_theme_apply | Changes | Applies a theme to one bio page, replacing its colors, fonts, card and button styles (its sections, links and template layout stay). |
bio_pages_create | Changes | Creates a new, unpublished bio page with its address (slug), title and bio text, and returns it. |
bio_pages_update | Changes | Changes a bio page's own fields and returns it: display title, bio text, avatar or cover image URL, or its address (slug). |
bio_pages_publish | Publishes | Publishes a bio page: anyone with its /@ address sees it from then on. Always needs your approval. |
bio_pages_unpublish | Changes | Takes a bio page offline: its /@ address stops showing it to visitors (nothing is deleted; bio_pages_publish brings it back). |
bio_pages_set_default | Changes | Makes one bio page your default (main) page, the one Pointerly links to when it points at your bio; the previous default stops being it. |
bio_pages_delete | Deletes | Deletes a bio page with all its sections; its /@ address stops working (the links stay in the workspace). Always needs your approval. |
bio_items_remove | Changes | Takes one link off a links or highlights section (item id from bio_sections_list) and returns the section. |
bio_items_move | Changes | Moves one link item to the top or bottom of its section, or into another links or highlights section of the same page (toSection), and returns the section it ends in. |
Affiliate tags
See your tracking IDs, create and edit them, check what deleting one would affect, and delete one.
| Tool | Type | What it does |
|---|---|---|
affiliate_tags_list | Looks up | Lists your affiliate tags (tracking IDs) with their public id ("tag_…"), store, marketplace and whether each is the default, plus the total for paging. |
affiliate_tags_get | Looks up | Gets one affiliate tag of your workspace by its public id ("tag_…", from affiliate_tags_list): name, tracking ID, store, marketplace and whether it is the default. |
affiliate_tags_create | Changes | Creates an affiliate tag (tracking ID) for a store and marketplace, e.g. "jane-20" for Amazon US, and returns it with any warning about the tracking ID. |
affiliate_tags_update | Changes | Changes an affiliate tag (id from affiliate_tags_list): name, tracking ID, marketplace, or makes it the default for new links of its store and marketplace. |
affiliate_tags_delete_preflight | Looks up | Shows what deleting an affiliate tag would affect, without deleting: active links and variants using it, report imports and other history the delete removes, and the tags of the same store and marketplace that can take its links over. |
affiliate_tags_delete | Deletes | Deletes an affiliate tag permanently. Always needs your approval. |
affiliate_tags_stats | Looks up | Gets how each of your affiliate tags is used: active links on the tag and imported report files (count, last import time). |
Reports
Read totals and daily numbers from the store reports you imported, and see which report files are imported.
| Tool | Type | What it does |
|---|---|---|
reports_team_summary | Looks up | Gets totals from your imported store reports (Amazon, eBay, Walmart) for a date window: clicks, revenue and ad fees (commission) in cents, items shipped and orders. |
reports_team_daily_series | Looks up | Gets per-day clicks, orders and revenue (in dollars) from your imported store reports for a date window, keyed by YYYY-MM-DD. |
reports_imports_list | Looks up | Lists the report files imported for one affiliate tag (id from affiliate_tags_list), newest first: file name, period covered and import time, paged with limit/offset. |
Analytics
| Tool | Type | What it does |
|---|---|---|
analytics_overview | Looks up | Gets your click analytics for a date window, as the Analytics page shows them: clicks and conversions tracked by Pointerly, commission earned on those conversions, links count, per-day series, and (when the plan and access allow) the clicks, orders, sales revenue and Amazon ad fees from imported store reports, kept separate from tracked numbers. |
analytics_top_links | Looks up | Ranks your links by what they did inside a date window: tracked clicks, conversions, commission earned or conversion rate (conversions per click). |
analytics_link_report | Looks up | Gets one link's report for a date window, as its details page shows it: tracked clicks, conversions and commission per day, the extra clicks, conversions and sales revenue from imported store reports (Amazon figures split by click share when several links share an ASIN, an estimate), Sponsored Products earnings, and lifetime counters. |
Earnings
| Tool | Type | What it does |
|---|---|---|
earnings_summary | Looks up | Gets your earnings ledger for a date window, as the Earnings page totals it, one block per currency (never summed across currencies): money received (paid), money expected (forecast, pending, confirmed), sales volume, a split by source (brand deals, Creator Connect, Sponsored Products, publications, manual entries…) and per-period buckets, plus totals per affiliate tag. |
AI Content
Write posts, video scripts and other content with AI (uses AI credits), edit drafts, and publish or schedule them to your connected accounts.
| Tool | Type | What it does |
|---|---|---|
ai_content_post_generate | Changes | Generates and saves an AI Content post for 1-10 products in a post format (caption, carousel, thread, story frames, Telegram, email). |
ai_content_script_generate | Changes | Generates and saves a short-form video script (hooks, beats, CTA, caption, hashtags) for 1-10 products. |
ai_content_content_generate | Changes | Generates free-form content with the general writer for a platform and content type, from a product URL or description. |
ai_content_style_apply | Changes | Rewrites a text in one of your saved style profiles or in a style described in words. |
ai_content_post_update | Changes | Saves an edit to an AI Content post made by ai_content_post_generate and returns the updated record. |
ai_content_script_update | Changes | Saves an edit to an AI Content video script made by ai_content_script_generate and returns the updated record; patch.status "filmed" marks it ready for ai_content_script_publish. |
ai_content_post_reference | Looks up | Lists the active post formats, post types and disclosure rules. |
ai_content_script_reference | Looks up | Lists the active platform profiles, script types and disclosure rules. |
ai_content_templates_list | Looks up | Lists your saved content templates with the total count, filtered by platform, content type or text. |
ai_content_publish_options | Looks up | Gets where an AI Content post or filmed script can be published: each route (routeKey) with its connected destinations (destinationId, active or needing reconnect), media rules, blocking issues, checklist keys to confirm and keyword DM conflicts. |
ai_content_post_publish | Publishes | Publishes an AI Content post publicly now, or at scheduleAt, to destinations picked from ai_content_publish_options (routeKey + destinationId). Always needs your approval. |
ai_content_script_publish | Publishes | Publishes the recorded video of a filmed AI Content script publicly now, or at scheduleAt, to social accounts picked from ai_content_publish_options (routeKey + destinationId). Always needs your approval. |
Content Studio
See your connected social accounts, publishing queue and library, publish or schedule files from your library, retry or cancel publications, and write captions with AI.
| Tool | Type | What it does |
|---|---|---|
content_studio_accounts_list | Looks up | Lists your Instagram, Facebook, TikTok and YouTube accounts that Content Studio publishes to: id, platform, username, display name and isActive (false means it needs reconnecting in Pointerly). |
content_studio_distributions_list | Looks up | Lists Content Studio publications, newest first, with each destination's status, schedule, error and published URL. |
content_studio_library_list | Looks up | Lists media files your workspace already used in Content Studio publications, newest first, with where each went out. |
content_studio_preflight | Looks up | Gets what the platform reports about one social account before publishing. |
content_studio_distribution_create | Publishes | Publishes one media file to 1-10 social accounts, each with its own caption and format. Always needs your approval. |
content_studio_distribution_create_bulk | Publishes | Publishes up to 100 media files in one batch, one publication per file, each to its own social accounts. Always needs your approval. |
content_studio_distribution_dispatch_now | Publishes | Publishes now the destinations of a publication that wait in the queue without a date, instead of on the next tick. Always needs your approval. |
content_studio_target_retry | Publishes | Retries one failed or out-of-quota destination of a publication and tries to publish it now; if that attempt is refused it stays queued for the next tick. Always needs your approval. |
content_studio_cancel | Changes | Cancels the destinations of a publication that have not gone out yet, or one destination when destination is given. |
content_studio_caption_generate | Changes | Writes one caption with AI for up to 5 Pointerly links and the chosen platforms, within the tightest platform's length limit. |
DM automations
See, create, edit and delete your Instagram and Facebook DM automations and templates, switch automations on or off, check their activity, and resend failed DMs.
| Tool | Type | What it does |
|---|---|---|
dm_settings_get | Looks up | Gets your DM defaults that new automations start from: trigger keywords, comment replies, extra buttons, expiry, hourly DM cap and random wait between DMs. |
dm_rules_list | Looks up | Lists your DM automations (comment-to-DM rules on Instagram and Facebook), newest first, active and paused, with id, account, keywords and on/off state. |
dm_rule_get | Looks up | Gets one DM automation by id with its full configuration: keywords, DM message and card fields, link, posts it listens on, comment replies, schedule and safety limits. |
dm_rule_fields_get | Looks up | Gets the compact view of one DM automation that dm_rule_fields_update edits: keywords, comment replies, DM text, posts it listens on, whether it answers earlier comments, on/off state and pause reason. |
dm_templates_list | Looks up | Lists your saved DM message templates, newest first, with id, name, format and content. |
dm_activity_summary | Looks up | Summarizes your DM activity over the last N days (default 7, at most 30): triggers and sent, failed, dropped, queued and skipped DMs, delivery rate, split by trigger kind and per UTC day; optionally for some automations only. |
dm_dispatch_history | Looks up | Lists individual DM dispatches, newest first: who commented and what, which automation answered, status and error. |
dm_rule_create | Changes | Creates a DM automation that DMs people who comment on Instagram or Facebook posts, one rule per account given; returns the new ids, notices and whether it is on. |
dm_rule_update | Changes | Edits a DM automation's content and options; returns its id. |
dm_rule_fields_update | Changes | Edits part of a DM automation: adds or removes keywords, adds comment replies, changes the DM text or the posts it listens on; returns what changed. |
dm_rule_pause | Changes | Pauses a DM automation so it stops sending DMs; DMs still waiting in the queue are dropped. |
dm_rule_enable | Changes | Switches a DM automation on: from then on it DMs everyone whose comment matches its keywords (every commenter when it has none) on the posts it listens on, using the plan's DM allowance. Always needs your approval. |
dm_rule_delete | Deletes | Deletes a DM automation permanently together with its dispatch history; returns how many queued DMs were cancelled. Always needs your approval. |
dm_template_create | Changes | Saves a reusable DM message template (name, format and content) and returns it. |
dm_template_update | Changes | Updates a saved DM template's name, format or content (new content replaces the stored content as a whole); returns the template. |
dm_template_delete | Deletes | Deletes a saved DM template permanently. Always needs your approval. |
dm_dispatch_retry | Sends | Re-queues DMs that failed or were dropped before reaching the person: one dispatch, the given automations' or the whole team's; returns how many were re-queued. Always needs your approval. |
dm_accounts_list | Looks up | Lists your connected Instagram and Facebook accounts that DM automations can run on: id (socialAccountId for dm_rule_create and dm_posts_list), platform, platformUserId (targetId), handle and whether the platform signed it out (needsReconnect). |
dm_posts_list | Looks up | Lists recent posts, reels and stories of one connected Instagram or Facebook account, newest first, with the ids a DM automation listens on (publicationId plus aliasIds: pin them all for selected_content), caption, link, type and how many automations already use each. |
dm_activity_by_post | Looks up | DM activity per post over the last N days (default 7, at most 30): triggers and sent, failed, dropped, queued, pending, awaiting and retroactive DMs for each post or story, plus one row for DMs that came from direct messages; optionally for some automations only. |
dm_keyword_suggestions_list | Looks up | Lists pending keyword suggestions: words that several people commented on a post an automation listens on, which the automation's keywords did not match, strongest first. |
dm_keyword_suggestion_apply | Sends | Applies a keyword suggestion: adds the word to its automation's keywords and, when the automation is on, DMs the people who already commented it (within Meta's 7-day window) under the plan's DM allowance. Always needs your approval. |
dm_keyword_suggestion_dismiss | Changes | Dismisses a pending keyword suggestion: the word is not added and is never suggested again for that automation. |
dm_rule_conflict_check | Looks up | Checks, without changing anything, whether a DM automation could be on without colliding with another active one on the same posts (Meta allows one private reply per comment). |
dm_content_suggest | Looks up | Suggests trigger keywords and public comment replies for a DM automation, from your own data: the link's product and brand, words commenters used that no rule matched, and keywords used on other rules. |
Telegram
See your channels, posts and templates, write drafts, and publish, schedule, move or cancel posts.
| Tool | Type | What it does |
|---|---|---|
telegram_channels_list | Looks up | Lists the Telegram channels connected to your workspace, newest first: id, title, username, whether each is active and whether the deal autoposter is on. |
telegram_posts_list | Looks up | Lists your Telegram posts across all channels, newest first (default 50, up to 200): drafts, scheduled, published (with their Telegram URL) and failed or cancelled ones. |
telegram_templates_list | Looks up | Lists your saved Telegram post templates, newest first, with name, body, category and default flag; optionally of one category. |
telegram_post_draft | Changes | Saves a Telegram post as a draft on one of your channels and returns it. |
telegram_post_schedule | Publishes | Schedules a new post on an active channel and returns it. Always needs your approval. |
telegram_post_send | Publishes | Publishes a new post to an active Telegram channel now and returns it. Always needs your approval. |
telegram_post_send_test | Sends | Sends Pointerly's fixed test message to a channel to check the bot can post there, and returns the Telegram message id. Always needs your approval. |
telegram_scheduled_send_now | Publishes | Publishes a scheduled post now instead of at its time and returns it, using one post of the monthly Telegram allowance. Always needs your approval. |
telegram_scheduled_update | Changes | Replaces the text of a scheduled post and returns it; its time and channel stay (moving it is telegram_scheduled_reschedule). |
telegram_scheduled_reschedule | Changes | Moves a scheduled post to a new future time, another channel of your workspace, or both, and returns it. Always needs your approval. |
telegram_scheduled_cancel | Changes | Cancels a scheduled post before it goes out and returns its id. |
telegram_template_create | Changes | Saves a reusable Telegram post template (name, HTML body with optional {{deal.}}, {{link.}} and {{channel.*}} variables, category, default flag) and returns it. |
telegram_template_update | Changes | Changes a saved Telegram post template (name, body, category or default flag) and returns it; fields left out stay as they are. |
telegram_template_delete | Deletes | Deletes a saved Telegram post template for good and returns its id. Always needs your approval. |
See your WhatsApp numbers, subscribers, topics, templates and broadcasts, manage topics and subscribe words, and create, send, schedule or stop broadcasts.
| Tool | Type | What it does |
|---|---|---|
whatsapp_connections_list | Looks up | Lists your connected WhatsApp Business accounts and their sending numbers, with each number's messaging tier, quality rating and whether it can send. |
whatsapp_templates_list | Looks up | Lists the message templates your workspace can broadcast with (its own and installed Pointerly designs): name, language, Meta status and category. |
whatsapp_templates_catalog | Looks up | Lists Pointerly's ready-made template designs with their state for your workspace: ready, in_review, rejected, available to install, or locked by the plan's template allowance. |
whatsapp_contacts_list | Looks up | Lists your WhatsApp subscribers, newest first, with their consent status, plus the total count. |
whatsapp_contacts_memberships | Looks up | Gets which topics each given subscriber belongs to, as a map from subscriber id to topic ids. |
whatsapp_topics_list | Looks up | Lists your topics (audience lists) with their member counts. |
whatsapp_topic_audience_count | Looks up | Counts the opted-in subscribers of one topic: how many people a broadcast to it reaches. |
whatsapp_audience_reachability | Looks up | Checks, before composing a broadcast, how many of a topic's opted-in subscribers a given template sent from a given number can reach right now, and why the rest cannot. |
whatsapp_campaigns_list | Looks up | Lists your WhatsApp broadcasts, newest first, with status, mode and delivery counters. |
whatsapp_campaign_live_detail | Looks up | Gets where a broadcast's unsent messages are held (messaging tier, spending cap, waiting for the subscriber to write) and what its links earned. |
whatsapp_usage_summary | Looks up | Gets this billing period's WhatsApp template-send usage: sends used versus included, comped sends, overage so far and the spending cap. |
whatsapp_keywords_list | Looks up | Lists your subscribe words per number, with the topic each one lands people in, whether it is active and how many subscribers that topic has. |
whatsapp_assistant_messaging_settings_get | Looks up | Gets a number's Shop Assistant messaging settings: the daily-deals pull word and its aliases, the reminder before the 24h window closes, and the account language. |
whatsapp_assistant_topics_list | Looks up | Lists the Shop Assistant topics in menu order with their product sources, keywords, confirmation text and daily send time, plus the default topic id and starter presets when your workspace has no topics yet. |
whatsapp_topic_create | Changes | Creates a topic (audience list) and returns it. |
whatsapp_topic_rename | Changes | Renames a topic and sets its description. |
whatsapp_topic_add_contacts | Changes | Adds existing subscribers of your workspace to a topic (up to 500 per call) and returns how many were added. |
whatsapp_topic_remove_contacts | Changes | Removes subscribers from a topic and returns how many were removed. |
whatsapp_keyword_create | Changes | Creates a public subscribe word on one of your numbers: people who send it subscribe, optionally into a topic. |
whatsapp_keyword_update | Changes | Changes a subscribe word: the word itself, the topic it lands people in, its confirmation label, or switches it off or on. |
whatsapp_assistant_messaging_settings_update | Changes | Changes a number's Shop Assistant messaging: the daily-deals pull word, its aliases, the reminder before the 24h window closes, or the account language (en, es, pt). |
whatsapp_assistant_topic_messaging_update | Changes | Sets a topic's subscribe confirmation text and the default send time of its daily-deals lists. |
whatsapp_assistant_topic_update | Changes | Edits a Shop Assistant topic: name, description, WhatsApp menu line, product sources, whether the assistant answers from it, default topic, or menu order. |
whatsapp_campaign_create | Changes | Creates a draft WhatsApp broadcast to the opted-in subscribers of one or more topics, after the checks Meta would fail it for (number can send, approved template, template pack, audience). |
whatsapp_campaign_duplicate | Changes | Copies a broadcast as a new draft with the same number, template, topics and settings, re-checked like a new one, and returns the copy's id. |
whatsapp_campaign_pause | Changes | Pauses a running always-on broadcast: no new subscribers are enrolled until whatsapp_campaign_resume, and messages already queued still go out. |
whatsapp_campaign_stop | Changes | Ends an always-on broadcast for good: it stops enrolling new subscribers and is marked completed, but messages already queued are still delivered. |
whatsapp_campaign_cancel | Changes | Cancels a broadcast, one-shot or always-on (paused ones included), and every message it has not sent yet (queued, held or frozen). |
whatsapp_campaign_send_now | Sends | Sends a draft or scheduled broadcast now: queues one message per opted-in subscriber of its topics, within its sending hours, and returns how many were queued. Always needs your approval. |
whatsapp_campaign_schedule | Sends | Creates a broadcast that is sent automatically at scheduledFor, with no further human step, to the opted-in subscribers of its topics. Always needs your approval. |
whatsapp_campaign_resume | Sends | Presses play on an always-on broadcast: starts a draft (which first sends to everyone already opted in to its topics) or resumes a paused one after re-checking the number and template. Always needs your approval. |
whatsapp_assistant_daily_deal_schedule | Sends | Adds one of your links to the Daily deals lists of up to 10 topics on up to 14 days, creating lists as needed. Always needs your approval. |
whatsapp_keyword_delete | Deletes | Deletes a subscribe word, so sending it no longer subscribes anyone. Always needs your approval. |
whatsapp_template_install | Changes | Submits a Pointerly template design (key from whatsapp_templates_catalog) to one of your WhatsApp Business accounts for Meta review. Always needs your approval. |
Campaigns
See your brand campaigns and the marketplace, read a campaign brief, and create a campaign as a draft.
| Tool | Type | What it does |
|---|---|---|
campaigns_list | Looks up | Lists your own brand campaigns in any status, newest first, with budget, slots, applications count and dates (brand side). |
campaigns_marketplace_list | Looks up | Lists the active campaigns of every brand on the marketplace, the ones a creator can apply to, most recently published first. |
campaigns_get | Looks up | Gets one campaign by id or public id (camp_...) with its brief, requirements, budget, deliverables, products, slots and dates. |
campaigns_create | Changes | Creates a brand campaign as a draft in your workspace and returns it. |
Campaign applications
See applications to your campaigns or your own applications as a creator, apply to a campaign, and withdraw an application.
| Tool | Type | What it does |
|---|---|---|
applications_campaign_list | Looks up | Lists the creator applications to one of your own campaigns (brand side), with status, proposed rate and match score. |
applications_mine_list | Looks up | Lists your own applications to brand campaigns (creator side), in any status, with status, campaign and proposed rate. |
applications_approved_list | Looks up | Lists your contracted applications (then older approved ones), up to limit (default 5), creator side. |
applications_apply | Sends | Applies to an active marketplace campaign with your own creator profile and returns the application. Always needs your approval. |
applications_withdraw | Changes | Withdraws one of your own applications (creator side) while it is pending or negotiating, and returns its id. |
Integrations
| Tool | Type | What it does |
|---|---|---|
integrations_sheets_sources_list | Looks up | Lists the Pointerly data sources this connection may export to Google Sheets (id, name, description, audience), e.g. links, campaigns, bio pages. |
integrations_connectors_list | Looks up | Lists the third-party apps the workspace connected to Pointerly (e.g. Google Sheets, Notion) that this person and connection may use, each with its curated actions and whether each only reads. |
integrations_connector_read | Looks up | Runs one read-only action of a connected app on the workspace's account (e.g. read a Google Sheets range, query a Notion database) and returns the app's answer. |
integrations_connector_write | Changes | Runs one write action of a connected app on the workspace's account (e.g. write cells in Google Sheets, create a Notion page). Always needs your approval. |
Export
| Tool | Type | What it does |
|---|---|---|
integrations_sheets_export | Changes | Exports one Pointerly data source (up to 10,000 rows of your data) to your connected Google Sheets account: a new tab in spreadsheetId, else in the workspace's default export spreadsheet, else a new spreadsheet. Always needs your approval. |
Automations
See your automations and their runs, run one now, and switch one on or off.
| Tool | Type | What it does |
|---|---|---|
automations_list | Looks up | Lists your automations (v1 graphs and v2 workflows) with name, on/off, trigger, published revision, run count and last run status. |
automations_get | Looks up | Gets one automation of your workspace by id or public id: its steps (graph), trigger and config, on/off, published revision and run stats. |
automations_runs_list | Looks up | Lists the recent runs of one automation, newest first: run id, status, durable state, revision and error. |
automations_run_get | Looks up | Gets one automation run by id with its checkpoint: status, durable state, error and the input, output and error of every step. |
automations_run | Sends | Runs an automation once now, as you, and returns the run id and state. Always needs your approval. |
automations_toggle | Changes | Switches an automation on or off and returns it. Always needs your approval. |
automations_editor_get | Looks up | Everything needed to write a valid workflow definition: the step types and their config, the trigger types, every operation an action step can run (required fields, the permission it needs, the connection it takes, its outputs), the expression syntax, the publishing rules and the workspace's connections (ids for connection fields). |
automations_connections_list | Looks up | Lists the workspace connections a workflow step can name: connected apps (kind = provider, e.g. gmail, slack), Telegram channels (telegram) and WhatsApp numbers (whatsapp), with id and label only. |
automations_simulate | Looks up | Dry-runs a workflow definition on a sample trigger payload and returns its validation issues or, when it is valid, every step's input and output (checkpoint). |
automations_draft_create | Changes | Creates a new workflow automation, switched off, with the definition saved as its draft, and returns its ids and the issues that still block publishing. |
automations_update | Changes | Renames or redescribes an automation, or replaces its draft with a new definition, and returns it with the draft's remaining issues. |
automations_publish | Changes | Publishes an automation's saved draft as a new immutable revision and makes it the version that runs; returns the revision id. Always needs your approval. |
automations_delete | Deletes | Deletes an automation with its draft, published revisions and run history; if it was on, it stops running. Always needs your approval. |
automations_run_cancel | Changes | Cancels a queued, running or waiting workflow run and returns it. |
Deals
| Tool | Type | What it does |
|---|---|---|
deals_list | Looks up | Browses the deal catalog: active product deals already collected from the stores, best deal score first by default, with the total for paging. |
deals_get | Looks up | Gets one deal by its id (from deals_list, deals_search, deals_discover or deals_saved_list): title, store, current and original price in cents, discount, coupon or promo code, end date, rating and whether you saved it. |
deals_search | Looks up | Searches the stores now (Amazon, eBay and Walmart, or one of them) for products matching keywords, with current prices and discounts, and returns them as deals with ids (each result is added to the deal catalog). |
deals_discover | Looks up | Lists trending deals (the catalog's best of the last 72 hours plus fresh store results) or best sellers, optionally in one category. |
deals_categories_list | Looks up | Lists the deal categories with their slug and how many active catalog deals each holds (for the given stores, or all). |
deals_other_stores | Looks up | Finds the same product as a deal in the other stores (title and brand match), cheapest first, each with its price difference against the deal and a match confidence (0-1; below 0.6 may be a similar product, not the same one). |
deals_saved_list | Looks up | Lists the deals you saved (their own list, not your), with current catalog prices. |
deals_save | Changes | Saves a deal to your saved deals, to come back to it or link it later. |
deals_unsave | Changes | Removes a deal from your saved deals (id from deals_saved_list). |
Help center
| Tool | Type | What it does |
|---|---|---|
knowledge_search | Looks up | Searches the public Pointerly help center by meaning and returns the most relevant passages with their article title and public URL. |
Support
| Tool | Type | What it does |
|---|---|---|
support_topics_list | Looks up | Lists what a Pointerly support ticket can be about (product areas such as links, billing or DM automations), in display order, each with its key, a description, the category a ticket on it starts with and its help article. |
support_tickets_list | Looks up | Lists the workspace's Pointerly support tickets you may see, most recent activity first, with the total for paging. |
support_tickets_get | Looks up | Gets one support ticket by its public id ("tkt_…", from support_tickets_list) with its public conversation, oldest message first: what the workspace wrote, Pointerly support's replies, the Pointerly Assistant's answers and status notes. |
support_tickets_create | Sends | Opens a ticket with Pointerly support on behalf of you, who becomes its requester, and returns it. |
support_tickets_reply | Sends | Adds your message to one of the workspace's support tickets ("tkt_…", from support_tickets_list) and returns the updated ticket. |
Collaborations
| Tool | Type | What it does |
|---|---|---|
collaborations_brands_list | Looks up | Lists the brands in the creator’s Collaborations CRM (best value first by default) with status, tags, niches, outreach step, last contact, do-not-contact, open deals and the brand value score (fit, pay tier, reason). |
collaborations_brand_get | Looks up | Gets one brand of the Collaborations CRM: its prospect research (niches, research channel, work models, budget estimate), value score, notes, social handles, its contacts (name, role, email and whether the address works), its deals and its last 10 timeline entries. |
collaborations_deals_list | Looks up | Lists the creator’s brand deals (the Collaborations pipeline): title, stage, brand, contact, value, priority, key dates and next follow-up. |
collaborations_deal_get | Looks up | Gets one deal: stage, value and terms, deliverables, contact, the stages it may move to (and which need a signed contract first), its running sequences (with their enrollment ids) and its last 10 timeline entries. |
collaborations_activity_list | Looks up | The outreach history of a deal or a brand, newest first: emails sent and received, calls, notes, stage changes, follow-ups. |
collaborations_follow_ups_list | Looks up | Scheduled follow-ups, soonest first: reminders for the creator, emails set to send themselves (autoSend) and the next step of every running sequence. |
collaborations_templates_list | Looks up | The creator’s outreach email templates: name, kind (pitch, follow_up, negotiation…), subject, body and the {{variables}} it fills. |
collaborations_sequences_list | Looks up | The creator’s follow-up sequences: name, steps (day offsets, subject, text, stop on reply) and how many deals run each. |
collaborations_agents_list | Looks up | The workspace’s Collaborations agents (they pitch brands, follow up and work deals by email): name, kind, on/off, whether it works the whole team or one creator, triggers and last run. |
collaborations_approvals_list | Looks up | What the Collaborations agents drafted that waits for a person (pending, until it expires): emails to brands with their subject and text, and other proposed changes. |
collaborations_brand_create | Changes | Adds a brand to the Collaborations CRM, optionally with a first contact. |
collaborations_brand_update | Changes | Changes a brand: name, website, category, relationship status, tags, notes, niches, outreach step or do-not-contact (with a reason). |
collaborations_contact_create | Changes | Adds a contact (a person) to a brand: name and/or email, role, primary. |
collaborations_note_create | Changes | Adds a note to the timeline of a deal or a brand (internal: the brand never sees it). |
collaborations_deal_create | Changes | Opens a deal with a brand on the pipeline (default stage prospect), with value, terms, dates and deliverables. |
collaborations_deal_update | Changes | Changes a deal’s title, value, terms, contact, priority or dates. |
collaborations_deal_move_stage | Changes | Moves a deal to another stage (one of its allowedStages from collaborations_deal_get). |
collaborations_follow_up_create | Changes | Schedules a reminder for the creator to follow up on a deal or a brand at a time. |
collaborations_follow_up_update | Changes | Closes or pauses a follow-up: done (handled), cancel (it will not happen, an auto-send email included) or snooze until a time. |
collaborations_enrollment_pause | Changes | Pauses or stops a sequence running on a deal (pause keeps its place; cancel stops it and cancels its pending steps). |
collaborations_approval_update | Changes | Edits an agent’s email that waits for approval (only its editable fields, e.g. subject and body) without deciding it; it still waits for collaborations_approval_approve. |
collaborations_approval_reject | Changes | Discards an agent’s email that waits for approval: it is never sent. |
collaborations_outreach_draft | Changes | Writes an email to a brand as a draft in your workspace’s connected mailbox (Gmail, Outlook or IMAP): nothing reaches the brand until the creator sends it from their mailbox, then it counts as contact and starts follow-ups. |
collaborations_outreach_send | Sends | Sends an email to a brand from your workspace’s mailbox, after the person approves it in Pointerly. Always needs your approval. |
collaborations_follow_up_schedule_send | Sends | Schedules an email to a brand that sends itself at a time (approved now by the person, in Pointerly), on a deal or a brand. Always needs your approval. |
collaborations_sequence_enroll | Sends | Starts a follow-up sequence on a deal (approved by the person in Pointerly). Always needs your approval. |
collaborations_approval_approve | Sends | Approves an agent’s email that waits for approval (optionally with edits to its editable fields), after the person confirms it in Pointerly: it is sent (or saved as a draft when your workspace or the agent is in draft mode), filed on the brand’s deal, and the agent’s follow-ups start. Always needs your approval. |
collaborations_agent_run | Sends | Starts a Collaborations agent now (approved by the person in Pointerly): on the brands named (it works them as the person’s choice and does not skip them on its own rules), else a run with an optional task. Always needs your approval. |
Inbox
| Tool | Type | What it does |
|---|---|---|
inbox_mailboxes_list | Looks up | Lists the workspace's connected mailboxes (Gmail, Outlook, IMAP) with their id, address and whether each can read and send now. |
inbox_threads_list | Looks up | Lists email threads from Pointerly's Inbox index, newest activity first, with a cursor for more. |
inbox_messages_search | Looks up | Searches one mailbox with its provider's own search (Gmail, Outlook or IMAP), including mail Pointerly never indexed. |
inbox_thread_get | Looks up | Reads one email thread, oldest message first: sender, recipients, date and body as plain text (quoted history and text past 5,000 characters cut), plus attachment names and sizes (files cannot be downloaded). |
inbox_drafts_list | Looks up | Lists the drafts in one mailbox's Drafts folder, newest first, with a cursor for more, read live from the mailbox. |
inbox_messages_update | Changes | Marks up to 25 messages of one mailbox read or unread, or archives them (out of the inbox, still in the mailbox; nothing is deleted). |
inbox_draft_create | Changes | Saves a new email as a draft in the mailbox's Drafts folder; nothing is sent. |
inbox_draft_update | Changes | Rewrites the subject and body of a draft in the mailbox's Drafts folder; recipients and thread stay. |
inbox_draft_delete | Deletes | Moves a draft of the mailbox's Drafts folder to the trash. Always needs your approval. |
inbox_draft_send | Sends | Sends a draft of the mailbox's Drafts folder as it is (recipients, subject, body, thread) from that mailbox, then moves the draft to the trash. Always needs your approval. |
inbox_reply_send | Sends | Sends a reply to one message from the mailbox it is in, in the same thread: to its sender (or, for the mailbox's own sent mail, to its recipients); replyAll also copies the other recipients. Always needs your approval. |
Learn more
- For developers: the full technical reference, with the scopes and every parameter of each tool, is
docs/mcp-tools.mdin the Pointerly agent platform repository. - To change what an app may do, or to pause or revoke it, see Connected apps.