SUPERPROFILE MCP SERVER

SuperProfile MCP developer reference

Overview, setup guides and examples for creators: SuperProfile MCP server.

SuperProfile builds and runs its own remote MCP server; no Zapier or other third party is involved. Overview and setup guides: superprofile.bio/mcp.

SuperProfile guides

Connect an assistant that supports remote MCP and OAuth to manage 1:1 sessions and bookings, webinars, courses, locked content, lead magnets, digital products, payment pages, paid Telegram communities, and Instagram or Facebook Messenger Auto-DM automations. Available to every SuperProfile creator.

Connect

In Claude, add SuperProfile from the connector directory. In any other assistant, add https://mcp.superprofile.bio/mcp as a remote MCP server. Start its sign-in flow, choose the permissions you need, then approve in SuperProfile. Product-only access needs no Instagram account or Messenger Page. Select social accounts separately when using Auto-DM. Manage or revoke access in Connected agents.

Digital products and payment pages

Ask: “Create a draft payment page for my guide, upload this PDF, price it at ₹499, and show me the existing editor before publishing.” Start with get_product_context. Product tools cover digital offers, multi-item catalogs and eligible existing-product checkout pages.

List and read products; prepare and save drafts; edit, publish, unpublish, duplicate and delete eligible products. Configure supported prices and regional pricing, coupons, quantities, registration questions, content sections, policies, tracking IDs, themes and post-purchase behavior. Preserve the returned item IDs and read the current version before editing. Shared account credentials, payment onboarding and moderation decisions remain in their existing authorized setup flows.

Use list_product_assets to find verified uploads or attachments on an owned product. prepare_product_asset_upload returns a 24-hour transfer URL or browser file-selection link. Cover limit: 10 MiB; paid delivery: 100 MiB per item, subject to the shared quota of 512 MiB retained, 128 MiB per day and four pending uploads. Files upload outside MCP; size, SHA-256 and content type are checked before use. Paid files use private storage, and delivery videos wait for hosting/encoding. Poll the same operation after a timeout.

Create and edit bump offers, attach them to a page, and manage that page’s store placement separately. Product email tools manage purchase/cart rules, delays and templates with separate activation permission. Pause/delete change future matching; queued messages retain existing delivery behavior. Read sales, customers and analytics, or request a bounded private CSV export; customer contact data requires its own permission.

prepare_product validates a proposal without publishing. Commit its exact preview token with the matching draft/edit/publish tool and retain the same idempotency key after uncertainty. Money is expressed as decimal major-unit strings, such as "36.14" USD. Live or previously published edits require publication permission. A committed configuration may still be propagating or awaiting review: use get_operation and the returned state before calling it live. Existing buyers keep the existing download flow.

Courses, locked content and lead magnets

Start with get_course_context, get_locked_content_context or get_lead_magnet_context. Each family supports discovery, drafts, current-version edits, publishing, unpublishing, duplication, deletion, store placement and reports. Existing editors use the same authoring rules. Read each operation’s permissions and prerequisites; an older connection gains no new access automatically.

Courses include chapters and lessons, prerequisites and drip settings, supported live sessions and resources, quizzes and assignments, certificate settings, offers and email rules. Reading learner submissions and grading assignments require separate permissions. Locked content supports protected text and media. Lead magnets support registration questions, giveaway files, redirects, email rules and reusable template designs; sharing a template does not share private giveaway files or email configuration.

Use prepare_learning_asset_upload for course or locked-content media up to 5 GiB. Send file metadata and PUT bytes outside MCP, or open the returned browser upload link. The server verifies bytes and waits for video hosting before the asset becomes usable. Sessions last 24 hours; learning allowances are 20 GiB retained, 10 GiB selected uploads per UTC day and four pending sessions. Cover images and lead giveaway files use the product asset tools and their applicable limits. Consult the family context for smaller attachment limits.

New products, automations and posts start as drafts. Saving an edit to something already live applies when saved: a live product edit needs the publish permission, while an active Auto-DM automation can be changed with the edit permission alone. Creating and editing, publication, deletion, customer information and email activation are different permissions. Use get_operation until the requested generation finishes propagating. Reports name their source, coverage and uncertainty; CSV links expire and stop working when the grant is revoked. Buyer checkout, access and download flows remain in the existing product.

Webinars and events

Start with get_webinar_context. Prepare and save drafts for virtual, Zoom or in-person events, including sessions, tickets, bundles, discounts, questions, media, page content and tracking. Preserve returned child IDs and the current version when editing. Review the draft, then publish separately. Your existing event editor works with the same configuration.

Connect Zoom through the returned browser consent link. Meeting creation and updates may remain pending: poll get_operation, and review uncertain provider results in the event editor before retrying. Store placement, inactive automated-email rules, customer records and check-in have separate permissions.

get_webinar_analytics reads existing ticket totals, daily registration quantities, session and attribution counts, and dashboard visit metrics. Registration ranges are limited to 93 days; visit metrics retain the dashboard’s own periods. An unavailable source is reported explicitly. Native earnings are not a reconciled payout. get_webinar_insights reads the existing Insights feedback configuration.

Webinars continue to use the existing buyer checkout and registration flows. Attendee broadcasts, guest-invitation sending and review moderation are not exposed in this release. Deletion and cancellation through these tools are limited to events without registrations or sales; unpublishing closes new availability without removing attendee records.

1:1 sessions and bookings

Ask: “Create a 45-minute portfolio review call for ₹999 on Google Meet using my default availability, and show it to me before publishing.” Start with get_booking_context. Prepare and save inactive sessions with every step of the session editor: details, pricing and regional prices, meeting location, availability schedule, booking rules, questions, policies, testimonials and tracking. Preserve returned question IDs and the current version when editing, then publish separately as public or link-only.

Coupons, the session-recording add-on, booking page theme and regional pricing have their own tools and versions; coupon redemption counts are kept when a coupon changes. Availability schedules are read-only here and stay editable in the dashboard, as do calendar and Zoom connections.

list_bookings follows the dashboard views (upcoming, important, recurring, completed, cancelled) within a slot-start range of up to 93 days, and never returns meeting passwords or host room links. list_booking_responses and get_booking_response_analytics read reviews with the dashboard filters. Approving, rescheduling and cancelling customer appointments remain in the SuperProfile dashboard in this release.

Telegram communities

Ask: “Set up a paid Telegram community for my group at ₹499 a month and show it to me before publishing.” Start with get_telegram_community_context. Connect your Telegram account with begin_telegram_connection: sign-in happens on a SuperProfile page in your browser, and a phone code or password is never entered in chat.

List your Telegram groups and channels, prepare a community page over one, then publish, update its details and settings, unpublish, republish or delete eligible communities. Manage plans, registration questions, coupons, affiliate settings and store placement. Add, edit or remove members, resend an invite and cancel a member’s autopay. Read sales, members and analytics, or request a private CSV export; member contact data requires its own permission.

Paid Discord or WhatsApp communities, newsletters, and email or WhatsApp broadcasts are not available through these tools.

Instagram, Facebook Page and LinkedIn scheduling

Start with get_instagram_schedule_context. Tools:

Caption options (Instagram, Facebook Page and LinkedIn posts, not Stories): send captionOptions on prepare_scheduled_post as the whole list of 2 to 10 {id?, text} options ([] removes them) and selectedCaptionId for the one to publish; without it the current selection is kept, else the first option. The selected option is always the post's caption and is the only text published; the others are stored with the post and never posted. Each option has the platform's caption limits. Editing caption alone edits the selected option. get_scheduled_post and duplicate_scheduled_post return and copy the options. SuperProfile does not test or choose between them.

Trial reels (Instagram Reels only): set reel.trial on prepare_scheduled_post to MANUAL (the creator shares it with followers from the Instagram app) or SS_PERFORMANCE (Instagram shares it with followers if it performs well); null makes it a normal Reel. A trial reel is shown to people who don't follow the creator first. Instagram allows trial reels only on public professional accounts with at least 200 followers that can appear in recommendations. Otherwise SuperProfile marks the post as failed with its own reason code TRIAL_NOT_ELIGIBLE; nothing is retried as a normal Reel automatically, and the creator can choose to duplicate it without the trial setting. Reels only: not Stories, photos, carousels, Facebook Page or LinkedIn posts. Guide: Instagram trial reels.

Auto-DM on a scheduled Instagram Story: attach_auto_dm_to_scheduled_post on a story creates a story-reply automation instead of a comment trigger. When the Story publishes it is bound to that Story, so only people who reply to that Story with a message get the DM; replies to other Stories do not match. Keywords work as on posts (mode keywords or any). Comment replies are refused, because a Story has no comment thread for it, and Instagram Story comments are not read. Add it at least 10 minutes before the post time. To change a scheduled post to or from a Story, remove its Auto-DM first. Facebook Page Stories cannot take an Auto-DM. Guide: schedule an Instagram post, Reel or Story with Auto-DM.

Facebook Pages use the same tools and the same calendar. Post types: text, link, photo, album of 2 to 10 photos, video, Reel and Story. The Page must be connected in SuperProfile Auto-DM through Messenger. Attach an Auto-DM to a scheduled Page post (not a Story) and people who comment get your message in Messenger once the post is live.

LinkedIn (your personal profile) uses the same tools and the same calendar. Post types: text, photo, multi-image post of 2 to 20 images, video (MP4, 3 seconds to 15 minutes, up to 500 MB) and PDF document (up to 100 MB and 300 pages; pass fileName when you request the upload, because it becomes the document title on LinkedIn). Post text is up to 3,000 characters, and you can schedule from 2 minutes ahead (5 for media, 15 for video) up to 90 days ahead. Not available on LinkedIn: first comments, Auto-DM, a link field, collaborators, location, people tags, post insights and Company Pages; SuperProfile posts hashtags and @mentions as plain text. The creator connects LinkedIn in Schedule; LinkedIn authorization normally expires after 60 days and is not renewed automatically, so the creator reconnects there. An assistant cannot connect it. When reconnectRequired is true, or a post is set for after expiresAt, ask the creator to reconnect. An unconfirmed LinkedIn post stays unknown and is never sent again: ask the creator to check their profile.

Comment moderation

Read and change the setup with get_comment_moderation and set_comment_moderation: three rules (spam and promotion, links, and abuse or harassment), and for each rule you choose Ignore, Hide or Delete.

Brand Collab

list_brand_collab_requests lists sorted requests; get_brand_collab_setup and set_brand_collab_setup read and change the setup: on or off, up to 3 niches, accepted payment types and per-deliverable rates. When a brand's DM is missing the deliverables or budget, Brand Collab automatically asks for them from the creator's account a few minutes later: one ask, one follow-up only if the brand answers part of it, then a thank-you once everything is in. At most 3 short messages, never two in a row, and nothing is sent when the brand asks the creator something or once the creator replies. To stop it, switch Brand Collab off. These replies are always part of Brand Collab: there is no setting for them, and set_brand_collab_setup no longer accepts an autoAsk field (a request that sends one fails input validation). Brand Collab reads brand collaboration DMs on your Instagram for the offer: deliverables, budget or commission, who posts, and the brand's niche. Brand Collab is part of SuperProfile's paid plans, with up to 50 brand requests handled per creator per month.

DM menu, ice breakers and Story mention replies

Read the current setup with get_instagram_dm_features and change it with set_instagram_dm_feature: the persistent DM menu (up to 20 items, each a link or an automated reply; Meta suggests 5), ice breakers (up to 4 starter questions, shown in the Instagram app when someone opens a chat with the creator for the first time) and the Story mention auto-reply (for eligible Story mentions that Instagram delivers: one automated reply per fan in a rolling 24 hours, with no added delay or after 30 seconds, 1, 5 or 10 minutes). Get the creator's approval of both the wording and the on/off state first: saving needs the publish permission, because turning one on publishes it to Instagram, and editing one that is already on submits the change to Instagram (people with an existing chat may need to refresh their inbox to see it). Replies go through the same queue as other Auto-DM replies, so they are not instant. Instagram only, on every paid SuperProfile plan. Guide: Instagram DM menu, ice breakers and Story mention replies.

Start with an Auto-DM draft

“Create a draft automation for my Instagram post that sends my guide when someone comments INFO. Show me the draft before publishing.”

Choose permissions

To let your assistant make changes, choose draft/edit access when connecting. Publishing and deleting have separate permissions. Review the checked permissions before choosing Allow access. The permissions your assistant requests start ticked. Every other SuperProfile permission, including ones added after you first connected, is listed unticked under New permissions available, so you can add one there. Nothing is granted unless it is ticked when you choose Allow access.

If your assistant says it cannot make changes, reconnect it and request the missing permissions. Refreshing a token does not add permissions. Some clients need you to remove and add the connection again to open fresh consent. Your existing automations and other connections are unchanged.

Your assistant can list posts, stories and automations, prepare and save drafts, edit, duplicate, publish, pause or delete supported automations, and report recorded runs and tracked clicks. Saving uses save_auto_dm_automation (formerly save_automation_draft, still accepted): a new automation is saved as a draft and sends nothing until activate_automation, but saving an edit to an automation that is already on applies as soon as it is saved, so grant the "Save drafts, edit and pause automations" permission carefully. Instagram account consent requires you in a browser.

Automate the conversation

Start from comments on a specific, next or any post/reel, story replies, incoming DMs, live comments, or a fan sending you one of your posts or reels in a DM. Match configured keywords or any event. Reply publicly with up to three rotating comment replies. Add a follow request, collect an email address, choose delays and follow-ups, and use text, buttons, images, video, audio, PDFs or cards.

Buttons can link to one of your published products (payment pages, courses, webinars, 1:1 sessions, Telegram communities, locked content, lead magnets), your store or your referral link; the link is built for you. Follow-ups can run after a delay, when the link was not clicked, when there is no reply, when the product was or was not bought, when a lead form was not submitted, or as a referral-link nudge.

Connect Kit, Mailchimp or Klaviyo in Settings, then let your assistant choose where captured contacts go. It uploads your media and shows the complete draft before publication. New upload and destination permissions need your consent.

Comment and live workflows with variables or follow-ups need an opening message the recipient responds to. Meta’s messaging windows still apply. Next-post automations select the first eligible future post whose matching comment arrives. Your assistant can edit automations you built in the dashboard: settings you saved there stay as they are unless you ask to change them. Follow-ups must run within 23 hours of the fan's message; automations with later follow-ups stay editable in the dashboard.

Send another message when a fan taps

Ask your assistant to add a “Send a DM” button to a primary text or card message. The reply can contain text, an image, video, audio, a PDF or a card. The fan must tap the button before that reply is sent. This works on Instagram and Messenger and uses your existing plan permissions.

Button replies can include URL buttons; another Send-a-DM action inside that reply is not supported. Follow-ups keep URL buttons only. Ask the assistant to preserve returned button IDs when editing so previously sent buttons still point to the same reply.

Use your media

Your assistant can find verified files with list_assets or start prepare_asset_upload. A local assistant uploads straight from disk. A browser-only assistant gives you a link to select your file. The session lasts 24 hours; file bytes never go through MCP. Poll get_operation until verification finishes, then use the asset in a draft. Cards need a verified image.

Image/PDF limit: 8 MiB; audio/video: 25 MiB. The allowance is 512 MiB retained, 128 MiB/day and four pending uploads. Older dashboard attachments may not appear in the verified library. New library access needs your consent.

Facebook Messenger

Create automations for comments on a specific or any Page post, incoming DMs, referral links and QR codes. Share the returned Messenger link or download a black-and-white QR SVG. The recipient may need to tap Get Started.

Use text, buttons, verified media/cards, delays and after-delay follow-ups. Comment follow-ups require an opening message and recipient tap. Messenger follow gates, email capture, variables, public replies and conditional follow-ups are not supported.

Choose Messenger Pages explicitly when connecting your assistant. Existing Instagram permissions do not include Facebook Pages, and a Page connected only for ads still needs Messenger setup in Auto-DM. Custom-logo/color QR rules remain read-only.

All tools

Every public tool, grouped by product, with what it does and the permission it needs: SuperProfile MCP tools. The list is generated from the server's tool registry; your assistant lists only the tools your connection's permissions and plan allow.

Build an integration

Use MCP tool discovery and the backing tool schemas. Connect through the MCP URL; backing REST routes also require internal gateway authentication. OAuth supports S256 PKCE, rotating refresh tokens and revocation. Use the exact MCP resource URL during authorization and token exchange.

Read the saved version before editing. Every write takes an idempotency key: the current Unix time in milliseconds, a colon, then 16 or more new random letters or digits. Every get_*_context result returns serverTime to build it from, and a rejected key returns the server time and the clock difference. Reuse the same key and inputs after timeouts; get_operation retrieves the receipt. A version conflict requires rereading and reviewing the current configuration.

Tool discovery reflects your connection's permissions. get_product_context.operations and get_context.operations distinguish supported operations from currently authorized ones. Missing permissions return HTTP 403 with an insufficient_scope challenge and missingScopes/nextAction: reauthorize. Obtain fresh consent for the advertised scopes, then refresh tool discovery. Send one MCP request per HTTP POST.

Limits apply across your assistant connections. Respect retry guidance on 429/503 responses and keep the same idempotency key for uncertain writes. Invalid-input errors identify the fields to fix.

Understand the results

Drafts do not enable messages. Publishing needs explicit authority and the activation permission. Pausing prevents future automation evaluations; already selected or in-flight messages cannot be recalled.

Analytics uses explicit start-inclusive/end-exclusive windows and an IANA timezone, up to 90 days. Counts are events, not unique people or proof of delivery, reading, purchases or revenue. Freshness is unknown; recent events may still be processing.

A successful media upload or saved draft does not confirm delivery to the recipient. Meta may reject a file or message; verify your workflow with a test recipient before using it broadly.