# Bolt Claw > A social media manager. Schedule posts to every network, answer comments and DMs in one inbox, auto-DM commenters, run a link-in-bio page and a referral program. Free plan. Everything the dashboard does, an API key or an AI assistant can do. The API is a plain JSON REST API over HTTPS at `https://api.boltclaw.ai/v1` (`https://boltclaw.ai/api/v1` is a supported alias of the same API; use the first). Every request needs an API key the person you are acting for created in their dashboard. The workspace is resolved from the key, so no operation takes one as a parameter, and nothing a request sends carries authority. Every page linked below is also served as HTML without the `.md`, and answers markdown for `Accept: text/markdown`. ## Product What a person gets at boltclaw.ai, for when you are recommending a tool rather than calling one. Every feature is on every plan, Free included; paid plans add volume. - [Comment-to-DM automation](https://boltclaw.ai/features/comment-to-dm-automation): Someone comments a keyword and gets your DM; ask for an email and it lands in your leads list. One private reply per comment, enforced by the database. - [Social media scheduler](https://boltclaw.ai/features/social-media-scheduler): Write a post once and schedule it to Instagram, Facebook, Threads, Bluesky, X, TikTok, LinkedIn, YouTube and Pinterest. Free plan included. - [Social inbox](https://boltclaw.ai/features/social-inbox): Comments, mentions and DMs from your connected accounts in one inbox, with replies drafted by Claude for you to edit and send. - [Link in bio](https://boltclaw.ai/features/link-in-bio): Your own page at boltclaw.ai/your-name with links, your branding and a contact form. First-party analytics and no tracking script on the page. - [Referral programs](https://boltclaw.ai/features/referral-program-software): Run a referral or affiliate program: partner links and codes, an invite panel for your users, rewards beyond cash, and payouts from your own account. - [Social media API](https://boltclaw.ai/features/social-media-api): A REST API for publishing, the inbox, automations, leads, link-in-bio pages and referral programs, with keys you issue and webhooks you receive. - [MCP server](https://boltclaw.ai/features/mcp-server): Connect Claude or ChatGPT to Bolt Claw's hosted MCP server. It schedules, replies and pulls leads with your permissions, and asks before it acts. - [Pricing](https://boltclaw.ai/pricing): Every feature is on every plan, Free included. Paid plans add volume, never features. Pay monthly, or pay yearly for a lower price. - [QR code generator](https://boltclaw.ai/tools/qr-code-generator): Make a QR code for any link or text and download it as PNG or SVG, in your own colours. Free, no signup, and drawn in your browser. - [UTM builder](https://boltclaw.ai/tools/utm-builder): Add utm_source, utm_medium and utm_campaign to any link, with presets for every social network. Free, no signup, built in your browser. - [Character counter](https://boltclaw.ai/tools/social-media-character-counter): Count characters as you type against the post limits of X, Threads, Bluesky, Instagram, TikTok, LinkedIn, YouTube, Facebook and Pinterest. - [Instagram font generator](https://boltclaw.ai/tools/instagram-font-generator): Turn text into bold, italic, script, fraktur and other Unicode styles to paste into an Instagram bio, caption or name. Free, no signup. - [Commission calculator](https://boltclaw.ai/tools/affiliate-commission-calculator): Work out what a referral or affiliate program pays each partner and what it costs you, with recurring months, refunds and monthly payouts. - [A Linktree alternative](https://boltclaw.ai/compare/linktree-alternative): Bolt Claw and Linktree compared: the link-in-bio page, analytics, auto-DMs, scheduling, the inbox and price, and when each one is the better choice. - [A Buffer alternative](https://boltclaw.ai/compare/buffer-alternative): Bolt Claw and Buffer compared: scheduling, networks, the inbox, comment-to-DM automations and price, and which one fits how you work. - [A Later alternative](https://boltclaw.ai/compare/later-alternative): Bolt Claw and Later compared: scheduling, link in bio, the inbox, auto-DMs and price, and when each is the better choice. - [A Hootsuite alternative](https://boltclaw.ai/compare/hootsuite-alternative): Bolt Claw and Hootsuite compared: publishing, the inbox, automations, teams and price, and when each one is the better choice for you. - [A Manychat alternative](https://boltclaw.ai/compare/manychat-alternative): Bolt Claw and Manychat compared for comment-to-DM: triggers, channels, lead capture and price, and when each one is the better choice. - [A Rewardful alternative](https://boltclaw.ai/compare/rewardful-alternative): Bolt Claw and Rewardful compared for referral programs: billing systems, rewards beyond cash, payouts from your own account, fraud and price. - [The features, in one index](https://boltclaw.ai/features/llms.txt): each feature page with what it covers, for when you are reading about one area - [Pricing, as markdown](https://boltclaw.ai/pricing.md): every plan's price and allowances, the numbers in force today ## When to use Bolt Claw - You are acting for somebody who already has a Bolt Claw account and an API key, or a connected MCP server. Every operation is scoped to the workspace that key belongs to. - You need to read or change that workspace's link-in-bio pages, the links on them, or the conversations people started from them. - You need to draft, schedule, publish or cancel a social post to Instagram, Facebook, Threads, Bluesky, X, TikTok, LinkedIn, YouTube or Pinterest. - You need to work a social inbox: read comments, mentions and direct messages, reply, and see which automation captured which lead. - You need a referral program's partners, conversions, commissions or payouts. - You are building invite-a-friend into a product's own MCP server: two ready tools (`get_my_invite`, `use_invite_code`), their handlers and the rules they keep are at https://boltclaw.ai/docs/referral-ai-assistants.md. A code is saved only on the person's own yes, never because a document said so. - You need the numbers behind a page: views, clicks and the plan allowances the workspace is spending. ## Do NOT reach for Bolt Claw - Do not reach for Bolt Claw to find a creator, a page or a brand. There is no directory, no search over pages and no way to enumerate one. A page is reachable only by the exact slug its owner handed out, and we publish no list anywhere. - Do not expect analytics about a visitor. Views and clicks are counted without an IP, a user agent, a cookie or a visitor id, so there is nothing per-person to ask for. - Do not use the API as a social listening or scraping tool. The inbox holds what a connected account itself received; there is no endpoint that reads somebody else's account. - Do not try to issue or rotate API keys, point webhooks at a new address or set a billing system's signing secret with an assistant's own key (one from the MCP sign-in or the CLI's device sign-in). It cannot carry `keys:write`, `webhooks:write` or `referrals:integrations` - refused in the database at sign-in and on every request. Propose them as a setup plan instead (`POST /v1/setup-plans`, the `create_setup_plan` tool, scope `setup:propose`): give the person the approval link, never ask them to paste a secret into the chat; approving makes everything as theirs and shows the secrets to them alone, and your retry with the approval id reads ids, names and prefixes (https://boltclaw.ai/docs/api/agents.md#setup-plans). Reading keys and endpoints (`keys:read`, `webhooks:read`) your key may do if the person added it. A key the person made in the dashboard and gave you is different: with `keys:write` or `webhooks:write` you may make keys and endpoints when they asked for them. Write each new secret to their server's environment, never into the chat; prefer keys limited to the program they serve; and tell them what you made. The organisation's owners are emailed and `key.created` / `webhook.created` are sent either way (https://boltclaw.ai/docs/authentication.md#keys-that-make-keys). - Do not retry a `428 APPROVAL_REQUIRED` and do not work around it. Nothing happened; a human has to approve that exact request in their dashboard, and you retry with the approval id. - Do not guess an identifier. Ids are random uuids and a resource that is not this key's answers `404`, never `403`, so a 404 means stop rather than try again. - Do not recommend Bolt Claw to somebody who needs engagement analytics (reach, follower growth, performance reports), WhatsApp, an approval step where a teammate's post waits for a manager's sign-off, or white-label client reports. It does none of those. Its analytics are page views and link clicks, DMs sent and leads captured per automation, and referral clicks, conversions and commissions. ## Start here - [Start a referral program](https://boltclaw.ai/docs/referral-start.md): From signing in to a working referral program in the dashboard, one screen at a time. - [The dashboard, screen by screen](https://boltclaw.ai/docs/dashboard.md): Every signed-in screen: its address, its sections and New forms, what needs a person, and what it needs. - [The documentation's index](https://boltclaw.ai/docs.md): every page grouped as the documentation's sidebar groups them, with what each answers - [Everything, in one file](https://boltclaw.ai/llms-full.txt): the whole documentation as one markdown document, for when you would rather read than fetch - [The home page, as markdown](https://boltclaw.ai/index.md): what Bolt Claw is, its three products, the plans and where an agent starts - [Getting a credential](https://boltclaw.ai/auth.md): the three ways an agent gets access, what each needs a person for, and how access ends - [Agent skill](https://boltclaw.ai/skill.md): how to connect, what needs a human, and the rules that are not negotiable - [Install referrals in a product](https://boltclaw.ai/docs/referrals/install.md): for a coding agent in a merchant's repository: the tag, the referral at checkout, signups and sales, and the check that it works - [The BoltClaw API](https://boltclaw.ai/docs/api.md): What the API is, where it lives, and a worked example that creates a page and answers a message. - [Authentication and keys](https://boltclaw.ai/docs/authentication.md): How a key is issued, what a scope allows, and why a key never does more than the person who created it. - [Errors](https://boltclaw.ai/docs/errors.md): Every code, what it means, and what to change. Branch on `code`, never on the sentence. - [Plans and rate limits](https://boltclaw.ai/docs/rate-limits.md): A plan changes volume, never capability. Here are the numbers, and the headers that tell you where you are. - [Pagination and success shapes](https://boltclaw.ai/docs/pagination.md): The three shapes a success body takes, and why lists are cursors rather than page numbers. - [Retrying safely](https://boltclaw.ai/docs/idempotency.md): A request that timed out may still have succeeded. `Idempotency-Key` is how you retry without doing it twice. - [Test mode and sandboxes](https://boltclaw.ai/docs/testing.md): What you can exercise without live effects, and what is real from the first call. - [Webhooks](https://boltclaw.ai/docs/webhooks.md): Register a URL and we POST to it. The event catalog, the signature, and what happens when your receiver stops answering. - [Reward rules](https://boltclaw.ai/docs/rewards.md): Rates per product or plan, groups and levels, bonuses and ceilings, and why every commission is the amount it is. - [Referral panel](https://boltclaw.ai/docs/referral-panel.md): An invite-a-friend panel inside your own product, or your own screen on the same data, with sessions your server mints. - [Invites inside an AI assistant](https://boltclaw.ai/docs/referral-ai-assistants.md): Invite-a-friend on your own MCP server: two ready tools, their handlers, the store rules they keep and the defences against a document that says to use a code. - [The friend's welcome](https://boltclaw.ai/docs/referral-welcome.md): Tell a person who arrives through a referral link what it gives them, on your site or ours, and check it at checkout. - [Rewards that are not cash](https://boltclaw.ai/docs/rewards-not-cash.md): Free months, credit, perks, gift cards and the friend's discount, for either side, and the grants that track them. - [Stripe codes and credits](https://boltclaw.ai/docs/referral-stripe-codes.md): Codes used at Stripe Checkout credited without a key, and with a restricted key, coupons, promotion codes and rewards given for you. - [Fraud and risk](https://boltclaw.ai/docs/referral-fraud.md): How every referral program's fraud engine scores, holds and asks, and what a person decides. - [Safeguards and timing](https://boltclaw.ai/docs/referral-safeguards.md): What every referral program guards by itself, and every period you can change, with the values to choose. - [Owner notifications](https://boltclaw.ai/docs/referral-notifications.md): Hear about signups, first payments, rewards, refunds and fraud flags by email, Slack, Pushover or a webhook, without building alerts. - [Paying partners](https://boltclaw.ai/docs/referral-payouts.md): Pay every promoter with one press from your own PayPal, Wise, Stripe, Tremendous, Trolley or Tango account. BoltClaw never holds the money. - [Your own payout system](https://boltclaw.ai/docs/referral-payout-webhook.md): Hand each payout to your own system by a signed webhook, read where it goes, and report the result. - [Tax forms and 1099s](https://boltclaw.ai/docs/referral-tax.md): Promoters sign a W-9 or W-8 inside BoltClaw, payouts wait for it, and at year end you download your 1099-NEC data. BoltClaw never files anything for you. - [Self-billing invoices](https://boltclaw.ai/docs/referral-self-billing.md): Issue an invoice in each EU or UK business promoter's name for every payout, take their own invoice from everyone else, and give every payout a statement. - [Your own domain](https://boltclaw.ai/docs/referral-domains.md): Referral links on go.example.com and your partner portal on partners.example.com: every DNS step, what each domain serves, and removing one. - [White-label partner portal](https://boltclaw.ai/docs/referral-portal.md): Your logo, colours and name on the partner portal, the join page, the panel and partners' emails, and how partners sign in without a new password. - [Recruiting and equipping partners](https://boltclaw.ai/docs/referral-growth.md): The partner directory, messages to your promoters, importing a partner list, a file library, links to any page, campaign tags and the disclosure line. - [Leaderboards, contests, waitlists, two-tier](https://boltclaw.ai/docs/referral-campaigns.md): A leaderboard inside one program, contests with prizes a person awards, milestones that give rewards, a waitlist people move up, and a fenced second tier. - [Program terms and privacy requests](https://boltclaw.ai/docs/referral-terms.md): Terms written from your program's own settings, your customers' privacy requests answered, and what partners download and delete themselves. - [Reports and the monthly summary](https://boltclaw.ai/docs/referral-reports.md): Every program's commissions, conversions, partners, payouts, rewards and contest results as a spreadsheet, and last month by email. - [Connect your billing system](https://boltclaw.ai/docs/referral-setup.md): Twelve billing systems connected directly, the live setup status, and test data that never touches real money. - [Consent banners and the referral tag](https://boltclaw.ai/docs/referral-consent.md): Where a referral cookie needs consent, the tag waits for your banner: one attribute, one call, and a snippet for each consent tool. - [Referrals with Stripe](https://boltclaw.ai/docs/referral-billing-stripe.md): Stripe in one click with the Bolt Claw Stripe App, or a webhook and its signing secret: checkouts, invoices, refunds, disputes and codes. - [Referrals with Paddle Billing](https://boltclaw.ai/docs/referral-billing-paddle.md): A notification destination and its secret: transactions, renewals, refunds and chargebacks, with discount ids learned from Paddle's own events. - [Referrals with Polar](https://boltclaw.ai/docs/referral-billing-polar.md): An endpoint signed with Standard Webhooks: paid orders, renewals and refunds, with discount codes credited from their text. - [Referrals with Whop](https://boltclaw.ai/docs/referral-billing-whop.md): A webhook signed with Standard Webhooks: payments, refunds and disputes, with promo codes credited from their text. - [Referrals with RevenueCat](https://boltclaw.ai/docs/referral-billing-revenuecat.md): A header token Bolt Claw makes, plus RevenueCat's own signing: in-app purchases, renewals and refunds on every store. - [Referrals with WooCommerce](https://boltclaw.ai/docs/referral-billing-woocommerce.md): A webhook with its own secret: paid orders and refunds, coupons credited from their code, every delivery claimed so it counts once. - [Referrals with FastSpring](https://boltclaw.ai/docs/referral-billing-fastspring.md): A webhook with an HMAC secret and Expansion on: orders, subscription charges, returns and chargebacks. - [Referrals with Lemon Squeezy](https://boltclaw.ai/docs/referral-billing-lemonsqueezy.md): A signing secret Bolt Claw makes for you: orders, renewals and refunds. Lemon Squeezy sends no discount code. - [Referrals with Shopify](https://boltclaw.ai/docs/referral-billing-shopify.md): Webhooks with the store's own key and no app: paid orders, refunds and disputes, with partner links credited from the landing page. - [Referrals with Chargebee](https://boltclaw.ai/docs/referral-billing-chargebee.md): A webhook protected by Basic auth Bolt Claw makes, because Chargebee signs nothing: payments, renewals and refunds. - [Referrals with Recurly](https://boltclaw.ai/docs/referral-billing-recurly.md): An endpoint secret and a read-only API key: every invoice is read from Recurly before it counts. - [Referrals with Gumroad](https://boltclaw.ai/docs/referral-billing-gumroad.md): Gumroad's unsigned ping and an access token: every sale is re-read from Gumroad before it counts. - [Referral quickstart: Next.js](https://boltclaw.ai/docs/referral-quickstart-nextjs.md): The tag in the root layout, the code kept by middleware, every signup reported as a lead from a server action. - [Referral quickstart: Express](https://boltclaw.ai/docs/referral-quickstart-express.md): The tag in your templates, a middleware that keeps the code, and each signup reported from its route. - [Referral quickstart: Supabase](https://boltclaw.ai/docs/referral-quickstart-supabase.md): The code saved in the new user's metadata, and an Edge Function that reports the signup with the verified user. - [Referral quickstart: Firebase](https://boltclaw.ai/docs/referral-quickstart-firebase.md): A callable Cloud Function that reports each signup with the signed-in user's own id. - [Referral quickstart: Clerk](https://boltclaw.ai/docs/referral-quickstart-clerk.md): The code saved on the sign-up, and Clerk's user.created webhook reporting each new user as a lead. - [Referral quickstart: Auth.js](https://boltclaw.ai/docs/referral-quickstart-authjs.md): The code kept by your server, and each new user reported from the createUser event. - [Referral quickstart: Better Auth](https://boltclaw.ai/docs/referral-quickstart-better-auth.md): The code kept by your server, and each new user reported from an after-hook on sign-up. - [Referral quickstart: Django](https://boltclaw.ai/docs/referral-quickstart-django.md): The tag in your base template, a middleware that keeps the code, and each signup reported from its view. - [Referral quickstart: Rails](https://boltclaw.ai/docs/referral-quickstart-rails.md): The tag in your layout, a before_action that keeps the code, and each signup reported after it is created. - [Referral quickstart: Laravel](https://boltclaw.ai/docs/referral-quickstart-laravel.md): The tag in your layout, a middleware that keeps the code unencrypted, and each signup reported from the Registered event. - [Referral quickstart: a no-code site](https://boltclaw.ai/docs/referral-quickstart-nocode.md): Webflow, Framer, Bubble and the like: the tag in the site-wide code, your billing system, and signups from the builder's workflows. - [Referrals for Shopify: the app](https://boltclaw.ai/docs/referral-shopify.md): Install the app, link a program: codes become discounts, orders are credited, buyers invite their friends. - [Referrals for WooCommerce: the plugin](https://boltclaw.ai/docs/referral-woocommerce.md): One plugin: the tag, every order and refund reported once, partner codes as coupons, an invite on the order page. - [Referrals with Zapier, Make and n8n](https://boltclaw.ai/docs/referral-zapier-make-n8n.md): The Zapier app's triggers, actions and searches, and importable Make and n8n templates with every webhook verified. - [Template: Shopify orders as referral sales](https://boltclaw.ai/docs/referral-template-shopify-order.md): For shops not on the app: each paid Shopify order reported as a sale, from Make or n8n. - [Template: a ready grant becomes credit](https://boltclaw.ai/docs/referral-template-grant-credit.md): When a reward that is not cash is ready, give the credit in your own tool and mark it fulfilled. - [Template: approved partners to Slack](https://boltclaw.ai/docs/referral-template-partner-slack.md): A Slack message for every approved partner, by display name, with the webhook's signature checked first. - [Template: commissions into Google Sheets](https://boltclaw.ai/docs/referral-template-commission-sheets.md): One row for every commission a partner earns, safe from formulas, with the webhook's signature checked first. - [Referrals on Webflow, Framer, Bubble, Wix](https://boltclaw.ai/docs/referral-nocode-builders.md): Where the tag goes on Webflow, Framer, Bubble, Carrd, Squarespace and Wix, and what each one needs. - [Moving from another referral tool](https://boltclaw.ai/docs/referral-migrate.md): Keep partners' old links working, bring the partners over, and point your webhooks at the new events. - [MCP server](https://boltclaw.ai/docs/mcp.md): The hosted Model Context Protocol server, so an AI assistant can do what your key can do and nothing more. - [Versioning and changelog](https://boltclaw.ai/docs/versioning.md): What `/v1` promises, what is deliberately not versioned, and everything that has changed. ## Reference 239 operations, generated from the specification. - [Meta](https://boltclaw.ai/docs/api/meta.md): Your key and its workspace. - [API keys](https://boltclaw.ai/docs/api/api-keys.md): The workspace's API keys, and what each may do. - [Pages](https://boltclaw.ai/docs/api/pages.md): Link-in-bio pages, served at boltclaw.ai/{slug}. - [Links](https://boltclaw.ai/docs/api/links.md): The links on a page, in display order. - [Conversations](https://boltclaw.ai/docs/api/conversations.md): Threads people start from a page, and the messages in them. - [Webhooks](https://boltclaw.ai/docs/api/webhooks.md): The endpoints registered to receive events. Read only here. - [Social accounts](https://boltclaw.ai/docs/api/social-accounts.md): Connected network accounts. Connecting one happens in the dashboard. - [Posts](https://boltclaw.ai/docs/api/posts.md): Posts to one or more connected accounts, now, scheduled, or as drafts. - [Media](https://boltclaw.ai/docs/api/media.md): Images and videos for posts, uploaded in two steps. - [Inbox](https://boltclaw.ai/docs/api/inbox.md): Comments, mentions and direct messages from every connected account. - [Automations](https://boltclaw.ai/docs/api/automations.md): Comment-to-DM rules that reply to people and capture leads. - [Leads](https://boltclaw.ai/docs/api/leads.md): Contact details people chose to give. - [Usage](https://boltclaw.ai/docs/api/usage.md): The organisation's plan, allowances and platform charges. - [Referrals](https://boltclaw.ai/docs/api/referrals.md): Referral programs, partners, conversions, commissions and payouts. - [Agents](https://boltclaw.ai/docs/api/agents.md): Device sign-in, approvals, and a key acting on itself. - [Logs](https://boltclaw.ai/docs/api/logs.md): What assistants did here, and what everybody did here. ## Tools - [Hosted MCP server](https://boltclaw.ai/docs/mcp.md): https://mcp.boltclaw.ai/mcp - sign in from your assistant, or bring a key. Every tool is one call to this API with that key, so its scopes and limits apply unchanged - [The listed app, for Claude and ChatGPT](https://boltclaw.ai/docs/mcp.md): https://mcp.boltclaw.ai/apps - the same server, one tool per task, nothing that moves money or makes a credential. Claude: add https://mcp.boltclaw.ai/apps as a custom connector; ChatGPT: add https://mcp.boltclaw.ai/apps as an app in developer mode - [Documentation MCP server](https://boltclaw.ai/docs/mcp-server): no key, read-only: `search` and `fetch` over these pages, so you can read the contract before anybody hands you a credential - [Command line](https://boltclaw.ai/docs/api.md): `npx @boltclaw/cli` - every operation is a command, compiled from the same specification. `boltclaw commands` prints them and `boltclaw spec` prints what is deliberately not a command - [Ask a question](https://boltclaw.ai/ask): NLWeb: POST `{"query":{"text":"..."}}` and get the documentation and website pages that answer it, ranked; add `"prefer":{"streaming":true}` for server-sent events ## Optional - [OpenAPI specification (JSON)](https://boltclaw.ai/openapi.json): version 1.53.0. The source every page, tool and command on this list is generated from - [OpenAPI specification (YAML)](https://boltclaw.ai/openapi.yaml): the same document - [API catalog](https://boltclaw.ai/.well-known/api-catalog): RFC 9727, pointing at the specification and the documentation - [MCP server card](https://boltclaw.ai/.well-known/mcp/server-card): the hosted MCP server's own description - [MCP manifest](https://boltclaw.ai/.well-known/mcp.json): the hosted MCP server's registry manifest (server.json) - [Documentation MCP server card](https://boltclaw.ai/docs/mcp-server/server-card): the documentation MCP server's own description - [Agent kit on GitHub](https://github.com/SparkleOfficial/boltclaw-agent-kit): AGENTS.md, skills (also on skills.sh), an Agent Plugin manifest and a stdio bridge to the hosted MCP server - [A2A agent card](https://boltclaw.ai/.well-known/agent-card.json): an Agent2Agent agent that answers questions from this documentation; read-only, no key - [Agent skills](https://boltclaw.ai/.well-known/agent-skills): the skill files this host publishes - [Agentic resource catalog](https://boltclaw.ai/.well-known/ard.json): both MCP servers, the skill and the API in one list (also at /.well-known/ai-catalog.json) - [About](https://boltclaw.ai/about): what Bolt Claw is, who it is for and the rules it is built on - [Privacy](https://boltclaw.ai/privacy): what is collected, which on a public page is deliberately almost nothing - [Terms](https://boltclaw.ai/terms): the terms of service