Spica Post

● Active

com.spicapost/spica-post

Your AI assistant drafts, schedules and posts to your social accounts once you approve.

Connect this server

One click to install, or copy the config below. Suits: Cursor · HTTP clients.

Add to Cursor Add to VS CodeClaude Desktop / Claude Code: paste the config below.

Or add it manually — claude_desktop_config.json (Claude Desktop) or .cursor/mcp.json (Cursor):

{
  "mcpServers": {
    "spica-post": {
      "url": "https://app.spicapost.com/mcp"
    }
  }
}
One line, from the terminal
Claude Code
claude mcp add --transport http spica-post https://app.spicapost.com/mcp
VS Code
code --add-mcp '{"name":"spica-post","type":"http","url":"https://app.spicapost.com/mcp"}'

Syntax from each client's docs (Claude Code: claude mcp add; Codex: codex mcp add; VS Code: code --add-mcp). Placeholders in angle brackets are values you fill in. Codex takes hosted servers in config.toml ([mcp_servers.<name>] url = …) rather than on the command line.

A starting point — check the repository for exact arguments and setup. Restart your client after editing the config.

Category
Communication
Version
1.0.3
Registry
active
Published
11/19/2026
Listed in:Official MCP registry ↗how this is checked

Is it safe? Is it maintained?

Serverdex check: Nov 22, 2026

Mostly fine: Spica Post is maintained, hosted endpoint answering without a key.

Maintained
Active
Last commit 3 days ago (Nov 19, 2026), 0 open issues.
Official registry
Active
Published as com.spicapost/spica-post in the official MCP registry, version 1.0.3.
Source
No licence found
Public repository, but GitHub reports no recognised licence (0 stars). Check the README before shipping it in a product.
Runs
Hosted by the publisher
Your client talks to app.spicapost.com: prompts and tool arguments leave your machine for that host.
Credentials
None needed to connect
The hosted endpoint completed the Serverdex initialize + tools/list handshake with no key (checked Nov 22, 2026); individual tools may still ask for one.
Owner
Unclaimed
Nobody has claimed this page yet; the data above comes from the registry, GitHub and the live check.

Facts only: last commit and licence from GitHub, the entry's status from the official registry, credentials from the live check. Not a code audit — run the security scan on the endpoint yourself and see the status history.

Live check

checked Nov 22, 2026, 10:07 UTCStatus history & uptime →
● Working724 msprotocol 2025-06-18v0.1.0toolspromptsresources

The endpoint answered the MCP handshake as "Spica Post" and listed 133 tools. Answering since Nov 20, 2026.

Context cost ≈ 48k tokens of tool definitions a client loads per conversation (estimate: characters ÷ 4) across 133 tools.

Tools (133)

  • accounts_list1 param

    The social accounts connected to this workspace: each one’s id, network, name and status. Drafts are written for these ids. An account whose status is disconnected has to be connected again on the user’s account page before anything can be posted to it.

    Show parameters
    • brandIdstringThe brand this is for, by its id from brands_list. Needed when the login has more than one brand; with one brand it can be left out.
  • accounts_connect2 params

    Links the user opens to connect their social accounts, one per network, with what is already connected on each. A link opens their account page on that network: they press Connect and sign in on the network’s own page, so you never see a password (Bluesky instead takes a handle and an app password on that page; its link says so in `how`). Give them the link for each network they use, then call accounts_list to see what arrived. A network that cannot be connected yet answers ready: false and no link; say so instead of sending the user to it. Where there is a guide to opening an account on a network (a Google Business Profile, a Facebook Page, an Instagram professional account), `open` names it: read it with help_get for a user who has no account there yet. Use it for a first connection and for one that needs reconnecting. Changes nothing.

    Show parameters
    • networkstring | nullOne network by its key in capabilities, such as "instagram". Leave it out for every network that can be connected.
    • brandIdstringThe brand this is for, by its id from brands_list. Needed when the login has more than one brand; with one brand it can be left out.
  • site_study2 params

    The brand study: what the business really looks like, read from its own website. Answers its logo (the file of its own, never the logo of a platform the site is built on or a badge), the colours the logo is drawn in with their share, the brand colours those give, its own photos by address with their alt text, and notes on what could not be read. A website’s style sheets often carry the colours of the tool it was built with, so take the look from this, not from the site’s styles. Call it before drafting the brand, then import the logo and the best photos with media_from_url. Changes nothing.

    Show parameters
    • urlstringrequiredThe address of the business’s website, such as yourshop.com.
    • brandIdstringThe brand this is for, by its id from brands_list. Needed when the login has more than one brand; with one brand it can be left out.
  • posts_recent3 params

    What one connected account has posted lately, read from the network itself: each post’s words, when it went out, what kind it is and its link, with likes and comments where the network gives them. Read it during setup to hear how the business already writes, and before a new set of posts so nothing is said twice. Works for Bluesky, Instagram, Facebook Pages and Threads; for other networks read the account’s public page yourself. Changes nothing.

    Show parameters
    • accountIdstringrequiredAn account id from accounts_list.
    • limitintegerHow many posts to read, newest first, from 1 to 25. Ten when left out.
    • brandIdstringThe brand this is for, by its id from brands_list. Needed when the login has more than one brand; with one brand it can be left out.
  • What each network takes here: the longest caption and how it is counted, which file types, how many files (and whether a post needs one), and whether it has stories. Read it before writing for a network.

    Show parameters
    • brandIdstringThe brand this is for, by its id from brands_list. Needed when the login has more than one brand; with one brand it can be left out.
  • boards_list2 params

    The boards of one connected Pinterest account, read from Pinterest now: each board’s id and name, and which one its pins go to (chosen). To pin a post somewhere else, name a board in the draft’s options.board. Changes nothing.

    Show parameters
    • accountIdstringrequiredA Pinterest account id from accounts_list.
    • brandIdstringThe brand this is for, by its id from brands_list. Needed when the login has more than one brand; with one brand it can be left out.
  • tiktok_account_get2 params

    What one connected TikTok account allows, read from TikTok now: the visibility levels TikTok offers it (before TikTok’s audit, only Only me), whether the account has comments, duets or stitches switched off, and the longest video it may post. Use it to draft sensibly (a video under the limit) and to explain the choices the owner will make. Read only: who can see a TikTok post and how people may interact with it are chosen by the owner on the TikTok screen, never by you or the API (TikTok’s content sharing guidelines). Changes nothing.

    Show parameters
    • accountIdstringrequiredA connected TikTok account id from accounts_list.
    • brandIdstringThe brand this is for, by its id from brands_list. Needed when the login has more than one brand; with one brand it can be left out.
  • accounts_board3 params

    Changes which board a connected Pinterest account pins to when a post names none. The board is checked against the account’s boards on Pinterest first. Ask the user before changing it. Answers the account, whose name now ends in the board’s name.

    Show parameters
    • accountIdstringrequiredA Pinterest account id from accounts_list.
    • boardIdstringrequiredThe board’s id, from boards_list.
    • brandIdstringThe brand this is for, by its id from brands_list. Needed when the login has more than one brand; with one brand it can be left out.
  • boards_create4 params

    Makes a new public board on one connected Pinterest account, with a name and a description. Boards made here are always public: a secret board is refused (public_boards_only), so tell the user they can make it secret on Pinterest afterwards. Ask the user before creating or changing a board, and show them its name and description first. It is made once: if the answer is unclear, read boards_list before trying again, or the account gets two. Answers the new board: its id, its name and secret: false. Pins go to it when a draft names it in options.board, or every pin once accounts_board chooses it.

    Show parameters
    • accountIdstringrequiredA connected Pinterest account id from accounts_list.
    • namestringrequiredThe board’s name as it shows on Pinterest, up to 80 characters. Use a name the account has no board under yet.
    • descriptionstringWhat the board is about, up to 500 characters. Shown under its name on Pinterest. Left out, it has none.
    • brandIdstringThe brand this is for, by its id from brands_list. Needed when the login has more than one brand; with one brand it can be left out.
  • boards_edit5 params

    Renames or re-describes one board on a connected Pinterest account. Ask the user before creating or changing a board, and show them the new name or description first. Give a name, a description or both; what is left out stays. Answers the board as Pinterest now has it. Where it is the account’s chosen board, the account’s name follows the new board name.

    Show parameters
    • accountIdstringrequiredA connected Pinterest account id from accounts_list.
    • boardIdstringrequiredThe board’s id, from boards_list or boards_create.
    • namestringA new name, up to 80 characters. Left out, the name stays as it is.
    • descriptionstringA new description, up to 500 characters. Left out, it stays as it is.
    • brandIdstringThe brand this is for, by its id from brands_list. Needed when the login has more than one brand; with one brand it can be left out.
  • accounts_create_test3 params

    Add a practice account that posts nowhere, to try the flow. Its deliveries are simulated and marked as such. Refused where practice accounts are switched off.

    Show parameters
    • labelstringrequiredA name for the practice account.
    • modestringHow its deliveries end: success (the default), expired (fails as a lapsed connection), ambiguous (outcome unknown) or retry (rejected twice, then succeeds).
    • brandIdstringThe brand this is for, by its id from brands_list. Needed when the login has more than one brand; with one brand it can be left out.
  • accounts_disconnect2 params

    Disconnect one account. Its stored connection is deleted and its queued posts are cancelled, so nothing more is sent to it; posts already made stay in the history. The account stays in the list as disconnected until the user connects it again on their account page. Where the network allows it, this service also asks the network to revoke its access, and the answer waits for the network (up to about 20 seconds): account.revocation says what was revoked. status revoked: the network confirmed it. status unconfirmed: it was not revoked there, with the reason and, in message and settingsUrl, where the user removes the app themselves. A Google sign-in (YouTube, Business Profile) or a Facebook login that other connected accounts still use is left in place (reason shared) and revoked with the last of them. Ask the user first.

    Show parameters
    • idstringrequiredAn account id from accounts_list.
    • brandIdstringThe brand this is for, by its id from brands_list. Needed when the login has more than one brand; with one brand it can be left out.
  • drafts_list1 param

    Every draft in the workspace, with its current version and the link that opens it in the user’s composer.

    Show parameters
    • brandIdstringThe brand this is for, by its id from brands_list. Needed when the login has more than one brand; with one brand it can be left out.
  • drafts_search5 params

    Search and filter drafts by keyword (matching title or caption), account id or network, newest updated first, without loading the whole workspace’s drafts. Changes nothing.

    Show parameters
    • querystringCase-insensitive text to match against draft titles and variant captions.
    • accountIdstringFilter to drafts targeting this account id from accounts_list.
    • networkstringFilter to drafts targeting this network key, such as "linkedin" or "instagram".
    • limitintegerMaximum drafts to return, newest updated first. Defaults to 20.
    • brandIdstringThe brand this is for, by its id from brands_list. Needed when the login has more than one brand; with one brand it can be left out.
  • drafts_get2 params

    One draft: its title, its version and the text and media for each account. mediaRemovalAt, when present, is when its files will be removed if the draft is left unposted.

    Show parameters
    • idstringrequiredThe draft id.
    • brandIdstringThe brand this is for, by its id from brands_list. Needed when the login has more than one brand; with one brand it can be left out.
  • drafts_create3 params

    Create a draft: a title and one variant per account, each with its own text and media. Nothing is sent. Answers the draft with its id and version. Check it with drafts_validate and show it to the user before publish or schedule. A TikTok post also waits for the owner: TikTok has them choose, on a screen of ours, who can see each video, whether people may comment, duet or stitch, and whether it promotes a brand. Those choices cannot be sent here. When a draft has a TikTok account, the answer carries choose: one { accountId, network, link } per TikTok account still waiting; hand the user that link and wait for them to make the choices there (they can post from that screen too).

    Show parameters
    • titlestringrequiredA name for the draft in the user’s own list. It is never posted.
    • variantsarrayrequiredOne entry per account the post goes to, each with its own text and media.
    • brandIdstringThe brand this is for, by its id from brands_list. Needed when the login has more than one brand; with one brand it can be left out.
  • drafts_create_batch2 params

    Create 1 to 20 drafts atomically in one call, optionally tying each to its topicId and returning immediate validation results for every draft. Use this when drafting a full week at once. Nothing is published or scheduled; show every draft to the user for approval first.

    Show parameters
    • itemsarrayrequiredOne to 20 drafts to create, optionally link to topics, and validate atomically in one call.
    • brandIdstringThe brand this is for, by its id from brands_list. Needed when the login has more than one brand; with one brand it can be left out.
  • drafts_edit5 params

    Replace a draft’s title and variants. Send the whole draft, not only what changed, with the version you last read; the answer carries the next version. Refused with 409 when the draft changed in the meantime: read it again with drafts_get. Posts already queued keep the content they were queued with. Changing the text or video of a TikTok variant clears the choices the owner made for it on the TikTok screen, and they are asked again (choose has the link).

    Show parameters
    • idstringrequiredThe draft id.
    • versionintegerrequiredThe draft’s version as you last read it. A different number is refused, so nothing goes out with content the user did not see.
    • titlestringrequiredA name for the draft in the user’s own list. It is never posted.
    • variantsarrayrequiredOne entry per account the post goes to, each with its own text and media.
    • brandIdstringThe brand this is for, by its id from brands_list. Needed when the login has more than one brand; with one brand it can be left out.
  • drafts_validate3 params

    Check a draft against the rules of every network it goes to. Answers valid, and errors as plain sentences that say what to fix. ask, when present, lists what the user has not chosen yet and what happens if they do not (a YouTube video’s visibility): ask them, then set it with drafts_edit. Changes nothing. publish and schedule run the same check and refuse a draft that fails it. A TikTok post is not valid until the owner has made TikTok’s choices on the TikTok screen; choose lists the link to that screen for each TikTok account still waiting. Give the user the link; do not try to choose for them.

    Show parameters
    • idstringrequiredThe draft id.
    • versionintegerrequiredThe draft’s version as you last read it. A different number is refused, so nothing goes out with content the user did not see.
    • brandIdstringThe brand this is for, by its id from brands_list. Needed when the login has more than one brand; with one brand it can be left out.
  • drafts_validate_batch2 params

    Check 1 to 20 drafts against every network’s rules in a single call. Answers allValid and a per-draft result (valid, errors, ask, choose) without stopping on the first failure. Changes nothing.

    Show parameters
    • itemsarrayrequiredOne to 20 drafts to validate in a single call.
    • brandIdstringThe brand this is for, by its id from brands_list. Needed when the login has more than one brand; with one brand it can be left out.
  • drafts_duplicate3 params

    Make a fresh copy of an existing draft (version 1) with all of its variants, captions, media and network options, so you can adapt it without rewriting from scratch. TikTok owner choices are cleared so the owner chooses again on the TikTok screen. Posts nothing.

    Show parameters
    • idstringrequiredThe draft id to copy, from drafts_list or drafts_get.
    • titlestringA name for the new draft, up to 200 characters. Left out, the original title with "(copy)" is used.
    • brandIdstringThe brand this is for, by its id from brands_list. Needed when the login has more than one brand; with one brand it can be left out.
  • drafts_delete2 params

    Delete a draft, and with it each of its files that no other draft uses. Refused with 409 while one of its posts is queued or not yet confirmed. Posts already made stay in the history.

    Show parameters
    • idstringrequiredThe draft id.
    • brandIdstringThe brand this is for, by its id from brands_list. Needed when the login has more than one brand; with one brand it can be left out.
  • drafts_delete_batch2 params

    Delete 1 to 20 drafts atomically in one call, cleaning up files no other draft uses. Ask the user first. Refused with 409 (and nothing deleted) if any draft still has a queued or unconfirmed delivery.

    Show parameters
    • idsarrayrequiredOne to 20 unique draft ids from drafts_list or drafts_search to delete atomically.
    • brandIdstringThe brand this is for, by its id from brands_list. Needed when the login has more than one brand; with one brand it can be left out.
  • drafts_hold_list2 params

    Read every post currently waiting for an unconnected network (kept with drafts_hold), in full: its id, network, title, text, media ids, topic id, timestamps and account link. Optionally filter to one network. Changes nothing.

    Show parameters
    • networkstringFilter to one network key, such as "instagram". Leave out to list every waiting post.
    • brandIdstringThe brand this is for, by its id from brands_list. Needed when the login has more than one brand; with one brand it can be left out.
  • drafts_hold7 params

    Keep a post for a network the user has not connected yet, with its pictures, so it is not lost with the conversation. It shows on their account page next to that network’s Connect button, and becomes a draft by itself, for the new account, when they connect it. Use it only while accounts_list has no connected account for that network; otherwise write a draft with drafts_create. Up to 10 posts can wait. Answers the kept post and every post now waiting.

    Show parameters
    • networkstringrequiredThe network it is for, by its key in capabilities, such as "facebook". It must have no connected account yet.
    • textstringrequiredThe post, up to 20000 characters and within what that network takes (post_check says).
    • titlestringA short name for it, up to 200 characters. Left out, its first line is used.
    • topicIdstringThe topic it was written for, from topics_add. The draft is tied to that topic when the post becomes one.
    • mediaIdsarrayThe pictures or videos that go with it, by their ids (from templates_render, media_upload or media_from_url), within what that network takes. They are kept whil
    • idstringA waiting post from an earlier drafts_hold, to replace its words. Leave it out to keep a new post.
    • brandIdstringThe brand this is for, by its id from brands_list. Needed when the login has more than one brand; with one brand it can be left out.
  • drafts_hold_delete2 params

    Remove a post that was waiting for a network to be connected, when the user no longer wants it. Nothing else is touched. Ask the user first.

    Show parameters
    • idstringrequiredA waiting post, from drafts_hold or setup_start.
    • brandIdstringThe brand this is for, by its id from brands_list. Needed when the login has more than one brand; with one brand it can be left out.
  • publish4 params

    Post a draft now to every account in it. Call it only after the user said yes to this post. Answers one delivery per account in state queued, which means accepted, not posted: read jobs_get for the outcome and the link to the live post. One call counts as one post on the plan.

    Show parameters
    • idstringrequiredThe draft id.
    • versionintegerrequiredThe draft’s version as you last read it. A different number is refused, so nothing goes out with content the user did not see.
    • idempotencyKeystringrequiredA key you make up for this one request, 8 to 200 characters (a UUID works). Repeating the request with the same key answers the same deliveries and never posts
    • brandIdstringThe brand this is for, by its id from brands_list. Needed when the login has more than one brand; with one brand it can be left out.
  • schedule5 params

    Queue a draft to post at a later time, to every account in it. Call it only after the user said yes to this post and this time. Answers one delivery per account in state queued; a warning on a delivery means that account’s connection will lapse before then and the user should reconnect it. Refused when the time is further ahead than the plan schedules (usage_get says how far).

    Show parameters
    • idstringrequiredThe draft id.
    • versionintegerrequiredThe draft’s version as you last read it. A different number is refused, so nothing goes out with content the user did not see.
    • idempotencyKeystringrequiredA key you make up for this one request, 8 to 200 characters (a UUID works). Repeating the request with the same key answers the same deliveries and never posts
    • scheduledAtstringrequiredWhen to post, in UTC and ending in Z, for example 2026-11-06T14:00:00Z. Work it out from the user’s local time (usage_get names the workspace time zone). It mus
    • brandIdstringThe brand this is for, by its id from brands_list. Needed when the login has more than one brand; with one brand it can be left out.
  • schedule_batch3 params

    Schedule or queue 1 to 20 approved drafts atomically in one call (Studio and Pro). Each item takes either a future UTC scheduledAt or queue: true, not both. Call it only after the user said yes to every draft and its time. If any draft fails validation, version check, pace or plan limits, nothing is queued. Repeating with the same idempotencyKey and items answers the same deliveries and never posts twice.

    Show parameters
    • itemsarrayrequiredOne to 20 approved drafts to schedule or queue together atomically.
    • idempotencyKeystringrequiredA key you make up for this batch request, 8 to 190 characters (a UUID works). Repeating the request with the same key and items answers the same deliveries and
    • brandIdstringThe brand this is for, by its id from brands_list. Needed when the login has more than one brand; with one brand it can be left out.
  • queue_add4 params

    Queue a draft for the next free posting time, to every account in it, without choosing a date. Call it only after the user said yes to this post; tell them the time it was given. The time is the next of the saved posting times at which none of the draft’s accounts already has a post. Answers one delivery per account in state queued, with its scheduledAt. Refused when no posting times are saved yet (queue_set) or when every one the plan can schedule for is taken.

    Show parameters
    • idstringrequiredThe draft id.
    • versionintegerrequiredThe draft’s version as you last read it. A different number is refused, so nothing goes out with content the user did not see.
    • idempotencyKeystringrequiredA key you make up for this one request, 8 to 200 characters (a UUID works). Repeating the request with the same key answers the same deliveries and never posts
    • brandIdstringThe brand this is for, by its id from brands_list. Needed when the login has more than one brand; with one brand it can be left out.
  • queue_get1 param

    The saved posting times: each day’s own times (week), the time zone they are read in, and the next five. times and days say the same the short way, and uniform is true when every posting day has the same times. set is false until the user has chosen them.

    Show parameters
    • brandIdstringThe brand this is for, by its id from brands_list. Needed when the login has more than one brand; with one brand it can be left out.
  • queue_set4 params

    Save the posting times the queue uses, replacing the ones saved before: either the same times on some days (times and days), or each day’s own (week). To change one day, read queue_get, change that day in week and send the whole week back. Ask the user which days and times they want first. Posts that are already scheduled keep their times.

    Show parameters
    • timesarrayThe short way, for the same times on several days: one to twelve times of day on the 24-hour clock with two digits each, such as "09:00" or "17:30". They are re
    • daysarrayWith times: the days to post on, from mon, tue, wed, thu, fri, sat, sun. Every day when left out.
    • weekobjectEach day’s own times, for days that differ, such as { "mon": ["17:30"], "tue": ["09:00", "17:30"] }. A day left out has none. Send this or times and days, not b
    • brandIdstringThe brand this is for, by its id from brands_list. Needed when the login has more than one brand; with one brand it can be left out.
  • jobs_list1 param

    Every delivery, one per post per account: queued, posted, failed or cancelled, with its time, state, error and receipt.

    Show parameters
    • brandIdstringThe brand this is for, by its id from brands_list. Needed when the login has more than one brand; with one brand it can be left out.
  • jobs_query8 params

    Filter deliveries by state, network, accountId, draftId or UTC time range, capped at limit (default 30), with total count and network on each row. Use this instead of jobs_list in busy workspaces. Changes nothing.

    Show parameters
    • statestringFilter to one delivery state. When "queued", results sort soonest first; otherwise newest first.
    • networkstringFilter to one network key, such as "x", "linkedin" or "instagram".
    • accountIdstringFilter to one account id from accounts_list.
    • draftIdstringFilter to deliveries created from one draft id.
    • sincestringReturn deliveries at or after this UTC ISO timestamp.
    • untilstringReturn deliveries at or before this UTC ISO timestamp.
    • limitintegerMaximum deliveries to return (1 to 100). Defaults to 30.
    • brandIdstringThe brand this is for, by its id from brands_list. Needed when the login has more than one brand; with one brand it can be left out.
  • content_calendar_get3 params

    A day-by-day content calendar in the workspace’s own time zone (1 to 31 days, default 14): every scheduled, published and failed post with its local time, saved queue slots, open queue slots and empty-day counts. Use it to spot gaps and pick times accurately. Changes nothing.

    Show parameters
    • fromstringStart calendar date in the workspace time zone, formatted as YYYY-MM-DD. Defaults to today.
    • daysintegerHow many consecutive calendar days to return (1 to 31). Defaults to 14.
    • brandIdstringThe brand this is for, by its id from brands_list. Needed when the login has more than one brand; with one brand it can be left out.
  • brands_calendar_get2 params

    A unified day-by-day content calendar across every brand this login holds (1 to 31 days, default 14): every scheduled, published and failed post tagged with its brandId and brandName, plus per-brand summaries and overall counts. Ideal for agencies reviewing all clients at once. Changes nothing.

    Show parameters
    • fromstringStart calendar date formatted as YYYY-MM-DD. Defaults to today.
    • daysintegerHow many consecutive calendar days to aggregate across every brand (1 to 31). Defaults to 14.
  • brands_results_summary1 param

    Cross-brand performance rollup across every brand this login holds for the last 7, 30 or 90 days (Studio and Pro): per-brand posts, likes, comments, shares, views, reach and Google Business Profile numbers ranked by engagement, plus portfolio totals. Changes nothing.

    Show parameters
    • daysintegerHow far back to aggregate across every brand: 7, 30 or 90 days. 30 when left out.
  • results_get2 params

    How the posts of the last 7, 30 or 90 days did, the same numbers as the Results page: how many went out, their likes, comments and shares, views and reach where a network reports them, the same for the period before, each network’s share, the five posts that did best with their links, the times of the week the posts did best at (bestTimes, from the last 90 days; times is empty until enough posts have results), and what a post got on average with each hashtag (hashtags). Use it when the user asks how their posts are doing or what to post more of. notReported names networks posted to that gave no numbers. A post is read 1 hour, 1 day, 3 days and 7 days after it goes out, so a new post may have nothing yet. Where a Google Business Profile is connected, google holds what the profile itself got, by Google’s own count, over the same number of days ending three days ago (period): how many people called (calls), asked for directions (directions) or opened the website from it (websiteClicks), and how often it was seen (views, split into viewsInSearch and viewsInMaps). totals adds up every profile that was read and profiles lists each one; a profile whose state is no_reading gave no numbers just now, so say that and ask again later, and reconnect means the user reconnects it on their account page. google is null when no profile is connected. Where Google Search Console is connected, searchConsole holds the website’s Google Search performance over the same period ending three days ago: totals and previous ({clicks, impressions, ctr, position}), top search terms (queries) and top landing pages (pages), plus state (read, no_reading or reconnect). Part of Studio and Pro. Changes nothing.

    Show parameters
    • daysintegerHow far back to look: 7, 30 or 90 days. 30 when left out.
    • brandIdstringThe brand this is for, by its id from brands_list. Needed when the login has more than one brand; with one brand it can be left out.
  • jobs_get2 params

    One delivery and its outcome. state is queued, provider_accepted (the network has it and is still processing), published (receipt.url is the live post), failed (error says why), unknown (the outcome could not be confirmed: do not send it again, read it again later) or cancelled.

    Show parameters
    • idstringrequiredA delivery id from publish, schedule or jobs_list.
    • brandIdstringThe brand this is for, by its id from brands_list. Needed when the login has more than one brand; with one brand it can be left out.
  • jobs_cancel2 params

    Cancel one delivery that is still queued. Refused with 409 once it is being sent or has been sent. Each account of a post is its own delivery, so cancel each one that should not go out.

    Show parameters
    • idstringrequiredA delivery id from publish, schedule or jobs_list.
    • brandIdstringThe brand this is for, by its id from brands_list. Needed when the login has more than one brand; with one brand it can be left out.
  • jobs_cancel_batch2 params

    Cancel 1 to 20 queued deliveries atomically in one call. Call it only after the user said yes. If any delivery is already being sent or has finished, nothing is cancelled.

    Show parameters
    • idsarrayrequiredOne to 20 unique queued delivery ids from jobs_list, schedule or schedule_batch to cancel together.
    • brandIdstringThe brand this is for, by its id from brands_list. Needed when the login has more than one brand; with one brand it can be left out.
  • jobs_reschedule3 params

    Move one delivery that is still queued to another time in the future. Refused with 409 once it is being sent or has been sent. Each account of a post is its own delivery.

    Show parameters
    • idstringrequiredA delivery id from publish, schedule or jobs_list.
    • scheduledAtstringrequiredWhen to post, in UTC and ending in Z, for example 2026-11-06T14:00:00Z. Work it out from the user’s local time (usage_get names the workspace time zone). It mus
    • brandIdstringThe brand this is for, by its id from brands_list. Needed when the login has more than one brand; with one brand it can be left out.
  • jobs_reschedule_batch2 params

    Move 1 to 20 queued deliveries to new future times atomically in one call (Studio and Pro). Call it only after the user said yes. If any delivery cannot be moved or falls past the plan’s schedule horizon, nothing is moved.

    Show parameters
    • itemsarrayrequiredOne to 20 queued deliveries to move atomically.
    • brandIdstringThe brand this is for, by its id from brands_list. Needed when the login has more than one brand; with one brand it can be left out.
  • jobs_retry4 params

    Queue a fresh retry for one failed delivery (state failed), right away or at a chosen future time, without re-sending accounts that already succeeded. Call it only after the user says yes and any underlying issue (such as a lapsed connection) is fixed. Never retries a delivery whose state is unknown, queued, published or cancelled. Checks limits and network rules again; counts as one post on the plan.

    Show parameters
    • idstringrequiredA delivery id from publish, schedule or jobs_list.
    • idempotencyKeystringrequiredA key you make up for this retry, 8 to 200 characters (a UUID works). Repeating the request with the same key answers the same delivery and never posts twice.
    • scheduledAtstringWhen to retry, in UTC ending in Z. Leave out to retry right away; if given, it must be in the future.
    • brandIdstringThe brand this is for, by its id from brands_list. Needed when the login has more than one brand; with one brand it can be left out.
  • media_upload5 params

    Upload one picture or video to attach to drafts: PNG, JPEG, WebP or MP4, up to 10 MB. Answers its media id. A file that no draft uses is removed 24 hours after upload. Only for small files you already hold as base64: for a picture or video you made yourself, use media_upload_link, which is far quicker than writing the file out. Make a picture a JPEG: every network that takes pictures accepts JPEG, while Instagram refuses PNG and WebP (capabilities lists each network’s mediaTypes).

    Show parameters
    • namestringrequiredThe file name, for the user’s own list.
    • mimeTypestringrequiredThe file’s real format. A file whose bytes do not match is refused.
    • base64stringrequiredThe file’s bytes in standard base64, with no data: prefix. Up to 10 MB of file.
    • altstringWhat the picture shows, for people who cannot see it. Kept with the file.
    • brandIdstringThe brand this is for, by its id from brands_list. Needed when the login has more than one brand; with one brand it can be left out.
  • media_upload_link3 params

    A one-time link that takes one picture or video (PNG, JPEG, WebP or MP4), for a file you made or hold where sending it whole in media_upload is not practical, such as a picture drawn in your own sandbox. Send the bytes to url with PUT and its Content-Type, no sign-in needed; the answer is its media id. Where you cannot reach the web, give the user the file and the link: they open it, pick the file and press Upload; then media_list has it under the name you gave the link. One file per link; it ends after an hour. Nothing is posted. Make a picture a JPEG: every network that takes pictures accepts JPEG, while Instagram refuses PNG and WebP (capabilities lists each network’s mediaTypes).

    Show parameters
    • namestringA file name for the user’s own list. Taken from the file when left out.
    • altstringWhat the picture shows, for people who cannot see it. Kept with the file.
    • brandIdstringThe brand this is for, by its id from brands_list. Needed when the login has more than one brand; with one brand it can be left out.
  • media_from_url4 params

    Add one picture or video by its public web address instead of sending the file: PNG, JPEG, WebP or MP4, up to 10 MB. The service fetches it once and stores it; answers its media id, as media_upload does. Use it when the user points at a file that is already online. Refused when the address is not a public https one, cannot be fetched, is too large, or leads to a page instead of a file.

    Show parameters
    • urlstringrequiredThe https address of the file itself, one that opens the picture or video in a browser without signing in. Not the address of a page that shows it.
    • namestringA file name for the user’s own list. Taken from the address when left out.
    • altstringWhat the picture shows, for people who cannot see it. Kept with the file.
    • brandIdstringThe brand this is for, by its id from brands_list. Needed when the login has more than one brand; with one brand it can be left out.
  • usage_get1 param

    What the plan includes and what is used this month: posts, accounts and uploads, the workspace time zone, when the month ends, and the latest time a post can be scheduled for right now. Check it before queuing a batch.

    Show parameters
    • brandIdstringThe brand this is for, by its id from brands_list. Needed when the login has more than one brand; with one brand it can be left out.
  • workspace_overview1 param

    A single-call briefing of this workspace: brand readiness, connected and lapsed accounts, plan usage, posting queue, recent drafts, waiting posts, upcoming and recently failed deliveries, content counts (topics, articles, link pages, media kit, auto-replies, locations, custom fonts) and an attention list of what needs action right now. Changes nothing.

    Show parameters
    • brandIdstringThe brand this is for, by its id from brands_list. Needed when the login has more than one brand; with one brand it can be left out.
  • post_check6 params

    Would each network take this post? Give the text, the networks and how many photos and videos; answers for each network whether it is ready, what is wrong, and the length used against the limit. Needs no draft and changes nothing.

    Show parameters
    • textstringrequiredThe caption to check.
    • networksarrayrequiredNetwork keys to check against: x, linkedin, instagram, facebook, threads, bluesky, tiktok, youtube, google (Google Business Profile), pinterest.
    • imagesintegerHow many photos would be attached.
    • videosintegerHow many videos would be attached.
    • storybooleanTrue to check it as a story instead of a post.
    • brandIdstringThe brand this is for, by its id from brands_list. Needed when the login has more than one brand; with one brand it can be left out.
  • help_search2 params

    Search the help centre. Answers up to five matching articles; read one with help_get. Use it when the user asks how something works or why something was refused.

    Show parameters
    • querystringrequiredThe question in a few words.
    • brandIdstringThe brand this is for, by its id from brands_list. Needed when the login has more than one brand; with one brand it can be left out.
  • help_get2 params

    One help article as plain text, to read out or sum up for the user.

    Show parameters
    • idstringrequiredAn article id from help_search.
    • brandIdstringThe brand this is for, by its id from brands_list. Needed when the login has more than one brand; with one brand it can be left out.
  • settings_set_time_zone3 params

    Set the workspace time zone. The plan’s month and its counts follow it; the answer says from when the change applies.

    Show parameters
    • timeZonestringrequiredA time zone name such as America/Chicago or Europe/Madrid.
    • atSignupbooleanUsed by the app on a first visit. Leave it out.
    • brandIdstringThe brand this is for, by its id from brands_list. Needed when the login has more than one brand; with one brand it can be left out.
  • media_list1 param

    Every uploaded file: id, name, type, size and alt text. A file with purgedAt has been removed from storage and can no longer be attached.

    Show parameters
    • brandIdstringThe brand this is for, by its id from brands_list. Needed when the login has more than one brand; with one brand it can be left out.
  • media_update3 params

    Set or clear the accessible alt text on one uploaded picture or video, for example after looking at it with media_view. Refused with 410 if the file was already purged.

    Show parameters
    • idstringrequiredA media id from media_upload or media_list.
    • altstringrequiredAccessible description of what the picture shows, up to 1000 characters. Send empty text to clear it.
    • brandIdstringThe brand this is for, by its id from brands_list. Needed when the login has more than one brand; with one brand it can be left out.
  • media_delete2 params

    Remove one uploaded file from storage now. Refused with 409 while a draft uses it, while it is part of the saved brand, or while a post that uses it is still queued or not yet confirmed.

    Show parameters
    • idstringrequiredA media id from media_upload or media_list.
    • brandIdstringThe brand this is for, by its id from brands_list. Needed when the login has more than one brand; with one brand it can be left out.
  • media_view2 params

    Look at one stored picture of this workspace: the answer is the picture itself. Use it on every picture templates_render made, before showing it to the user: check that no line is cut off, that the words fit their space and that the photo sits well, and render again if not. A video answers with its still picture. Changes nothing.

    Show parameters
    • idstringrequiredA media id from media_upload or media_list.
    • brandIdstringThe brand this is for, by its id from brands_list. Needed when the login has more than one brand; with one brand it can be left out.
  • setup_start2 params

    Start here when the user asks to be set up or no brand is saved, and again whenever you have lost your place. Say in can what you can do (open web pages, open the user’s files, look at pictures) and each step is worded for that. Answers where the workspace stands, the short first steps that end in a first post and what to offer after it (each with an id, what to do and whether it is done), which step is next, and the fields of a brand. Changes nothing.

    Show parameters
    • canWhat you can do, so each step is worded for you. Leave it out and the steps are the general ones.
    • brandIdstringThe brand this is for, by its id from brands_list. Needed when the login has more than one brand; with one brand it can be left out.
  • brands_list

    The brands this login holds, each with its id and name, and which one a call goes to when it names none (current). Every other tool takes brandId, an id from here: with more than one brand, name it in every call, and tell the user which brand a post is for before they say yes to it. Changes nothing.

  • brands_create2 params

    Add a new brand workspace under this login (Starter holds 1 brand, Studio 5, Pro 20). Returns the new brand id so you can pass it as brandId to setup_start, brand_save, drafts_create and every other tool. Ask the user for the brand name (and optional website) first.

    Show parameters
    • namestringrequiredName of the new brand, 1 to 80 characters, such as "Casa Verde Florist".
    • websitestringOptional public https:// website address for the brand, up to 2048 characters. When given, its logo is imported automatically if found.
  • brands_move_account3 params

    Move one connected social account from one brand you own to another without reconnecting it on the network (hosted app, Studio and Pro). Queued posts for that account on the source brand are cancelled, and its connection is re-sealed under the destination brand. Ask the user for explicit confirmation first, naming the account, source brand and destination brand.

    Show parameters
    • fromBrandIdstringrequiredSource brand id from brands_list that currently holds the connected account.
    • toBrandIdstringrequiredDestination brand id from brands_list (owned by this login) to move the connected account into.
    • accountIdstringrequiredConnected account id from accounts_list on the source brand to move.
  • brands_overview

    A single-call portfolio briefing across every brand this login holds: each brand’s readiness, connected and lapsed accounts, queued/published/failed deliveries, drafts, waiting posts and attention items, plus portfolio-wide totals. Ideal for multi-brand owners and agencies checking every client at once. Changes nothing.

  • brand_get1 param

    The saved brand of this workspace (business, voice, look, offers, what never to say), or null before setup. Read it before writing any post.

    Show parameters
    • brandIdstringThe brand this is for, by its id from brands_list. Needed when the login has more than one brand; with one brand it can be left out.
  • fonts_list1 param

    The custom font families uploaded by the user on their brand page (family name, format, size and upload time, never the font bytes). Read this before choosing brand fonts or rendering templates so you can use a family the business already uploaded. Changes nothing.

    Show parameters
    • brandIdstringThe brand this is for, by its id from brands_list. Needed when the login has more than one brand; with one brand it can be left out.
  • brand_save2 params

    Save the brand you drafted during setup. Send the whole brand each time: it replaces the saved one. Set confirmed to true only after the user agreed to your summary.

    Show parameters
    • brandobjectrequiredThe whole brand. Send every part each time: what is left out is cleared, except the parts the user set by hand (brand.owned), which are kept.
    • brandIdstringThe brand this is for, by its id from brands_list. Needed when the login has more than one brand; with one brand it can be left out.
  • brand_rename2 params

    Rename this brand, only when the user asks for it. The new name shows on every page, in the brand switcher and in posts from now on, and it counts as set by the user, so brand_save keeps it. Changes nothing else; posts already published keep the name they went out with.

    Show parameters
    • namestringrequiredThe brand’s new name, as the user said it: one line, up to 80 characters.
    • brandIdstringThe brand this is for, by its id from brands_list. Needed when the login has more than one brand; with one brand it can be left out.
  • templates_list1 param

    The post templates this workspace can use, with what each is for.

    Show parameters
    • brandIdstringThe brand this is for, by its id from brands_list. Needed when the login has more than one brand; with one brand it can be left out.
  • templates_get2 params

    One template: its page types, every field with its limits, and a filled example for the trade.

    Show parameters
    • idstringrequiredA template id from templates_list.
    • brandIdstringThe brand this is for, by its id from brands_list. Needed when the login has more than one brand; with one brand it can be left out.
  • templates_render6 params

    Fill a template with words. The service draws each page in the saved brand’s colours and fonts, saves it as a picture and answers the media ids, in page order, ready to attach to a draft. Look at each one with media_view before the user sees it. A photo on a page is one the user already uploaded (its media id from media_list) or an https address.

    Show parameters
    • idstringrequiredA template id from templates_list.
    • seriesstringA short series name shown on the pages, where the template has one.
    • languagestringThe language of the words the service prints itself, such as the days of the week and "Closed": English (en), Spanish (es), Portuguese (pt), French (fr) or Hait
    • cutstringThe shape of the pictures, one per network: portrait (1080 by 1350) for Instagram, Facebook, LinkedIn and Threads; landscape (1600 by 900) for X and Bluesky; pi
    • pagesarrayrequiredThe pages in order, as many as the template takes. A carousel ends on an action page.
    • brandIdstringThe brand this is for, by its id from brands_list. Needed when the login has more than one brand; with one brand it can be left out.
  • profile_get1 param

    The saved industry profile (who buys, the questions they ask, what converts, the local angle, sources, guardrails) or null, with what each of its parts is for. Read it before choosing a topic or writing an article.

    Show parameters
    • brandIdstringThe brand this is for, by its id from brands_list. Needed when the login has more than one brand; with one brand it can be left out.
  • profile_save2 params

    Save the industry profile you researched during setup. Send the whole profile each time: it replaces the saved one. Needs a saved brand.

    Show parameters
    • profileobjectrequiredThe whole profile. Send every part each time: it replaces the saved one.
    • brandIdstringThe brand this is for, by its id from brands_list. Needed when the login has more than one brand; with one brand it can be left out.
  • articles_list1 param

    The articles kept for this workspace, newest first: title, address, status and length, without the words themselves. One that is on the user’s blog here says where (blogAddress) and whether a visitor gets it right now (blogLive).

    Show parameters
    • brandIdstringThe brand this is for, by its id from brands_list. Needed when the login has more than one brand; with one brand it can be left out.
  • articles_get2 params

    One article in full: its Markdown, the same words as clean HTML ready to paste into the user’s site, the search markup (schema) that goes on the same page, and where it is on the user’s blog here when it is on it.

    Show parameters
    • idstringrequiredAn article id from articles_list or articles_save.
    • brandIdstringThe brand this is for, by its id from brands_list. Needed when the login has more than one brand; with one brand it can be left out.
  • articles_save20 params

    Keep an article you wrote for the user, or the next version of one. It reaches readers one of two ways. On the user’s blog here: send blog true with status ready, and it is public at their link page’s address followed by /blog, in their brand (a workspace with one link page gets its blog there; with several, links_save with showBlog chooses the page; with none, make one first). Or on the user’s own site: they paste it in, and you then save its address as url with status published. Either way posts can link to it. An article on the blog can carry a cover picture (image) and pictures in its words, each one of the user’s own stored pictures. The same piece in two languages is two articles: save each in its own language, then name one in the other’s twinId. Send every field again with each version: a field left out is removed. Judge it with grader_get first, tie it to its topic with topicId, and put nothing on the blog without the user’s yes to that article.

    Show parameters
    • idstringThe article to replace. Leave it out for a new article.
    • versionintegerWith id: the version you read, so an edit made meanwhile is not overwritten.
    • titlestringrequiredThe headline, up to 160 characters.
    • bodystringrequiredThe article as Markdown, without its title: ## and ### headings, paragraphs, lists, tables, **bold**, *italic* and [links](https://…). On the blog a numbered li
    • summarystringWhat a search result shows under the title, up to 160 characters.
    • slugstringThe last part of the page’s address: lower-case letters, numbers and hyphens, up to 80 characters. Made from the title when left out.
    • keywordstringThe question or search phrase the article is meant to win, up to 120 characters.
    • languagestringThe language it is written in, up to 40 characters. English when left out.
    • topicIdstringThe topic in the ledger this article covers, from topics_list.
    • statusstringdraft while you work on it, ready once it passes the grader and the user has agreed, published once the user has put it on their own site (url is then needed).
    • urlstringThe https address where the article now lives on the user’s own site, up to 300 characters.
    • blogbooleantrue puts the article on the user’s blog here, at the address of their link page followed by /blog. Left out or false, it is not on the blog. It needs status re
    • publishAtstringFor the blog: the moment the article goes out, which is also the date it is shown with, with its time zone, such as 2026-10-13T09:00:00-04:00. A later moment ma
    • faqarrayUp to 8 questions the article answers, each with its answer. On the blog they are shown in full under the article and given to search engines word for word.
    • sourcesarrayWhere each number in the article comes from, up to 12. A number with no source does not go in the article.
    • tagsarrayUp to 12 short tags, each up to 40 characters. On the blog, articles that share a tag are offered to the reader next.
    • imagestringThe cover picture, by its media id (from media_upload, media_from_url or media_list). On the blog it is shown under the headline, small beside the article in th
    • imageAltstringWhat the cover picture shows, in one plain sentence, for a reader who cannot see it. Up to 200 characters. Needs image.
    • twinIdstringThe id of the same article in another language, from articles_list. It ties the two from either side: on the blog each then names the other to search engines, a
    • brandIdstringThe brand this is for, by its id from brands_list. Needed when the login has more than one brand; with one brand it can be left out.
  • articles_delete2 params

    Remove an article from this workspace. If it was on the user’s blog here it leaves the blog at once. Nothing on the user’s own site is touched.

    Show parameters
    • idstringrequiredAn article id from articles_list.
    • brandIdstringThe brand this is for, by its id from brands_list. Needed when the login has more than one brand; with one brand it can be left out.
  • locations_list1 param

    The locations of this workspace, each with the connected accounts that belong to it, and the accounts that belong to none. To post to a location, use the ids of its accounts as the destinations of the draft. Part of Pro.

    Show parameters
    • brandIdstringThe brand this is for, by its id from brands_list. Needed when the login has more than one brand; with one brand it can be left out.
  • locations_save6 params

    Make a location, or change one: its name, where it is, who its report is for, and which connected accounts belong to it. Use it when the user has several branches, or posts for several clients. An account belongs to one location at a time. Part of Pro; refused on other plans.

    Show parameters
    • idstringA location id from locations_list, to change that one. Leave out to make a new location.
    • namestringWhat the location is called, for example the branch or the client, up to 80 characters. Needed for a new one.
    • placestringWhere it is, for example "Hialeah, FL", up to 120 characters.
    • clientstringWho its report is for, when the user posts for someone else, up to 120 characters.
    • accountIdsarrayThe connected accounts that belong to it, as ids from accounts_list. This replaces the list. An account leaves any other location it was in.
    • brandIdstringThe brand this is for, by its id from brands_list. Needed when the login has more than one brand; with one brand it can be left out.
  • locations_delete2 params

    Remove a location. Its accounts stay connected and belong to no location; nothing that was posted is touched.

    Show parameters
    • idstringrequiredA location id from locations_list.
    • brandIdstringThe brand this is for, by its id from brands_list. Needed when the login has more than one brand; with one brand it can be left out.
  • locations_report3 params

    What one location did in the last 7, 30 or 90 days: how many posts went out and where, what they got, which did best, what failed and what is scheduled next. `text` is the same thing in plain words, ready for the user to send to the branch or the client: show it to them as it is. Without an id the answer is every location side by side for the same period, with the totals of all of them. Part of Pro; refused on other plans.

    Show parameters
    • idstringA location id from locations_list. Leave out for every location side by side.
    • daysintegerThe period, counted back from now: 7, 30 or 90 days. 30 when left out.
    • brandIdstringThe brand this is for, by its id from brands_list. Needed when the login has more than one brand; with one brand it can be left out.
  • autoreplies_list1 param

    List Instagram comment rules with their trigger words, message, on/off setting and confirmed number sent.

    Show parameters
    • brandIdstringThe brand this is for, by its id from brands_list. Needed when the login has more than one brand; with one brand it can be left out.
  • autoreplies_save8 params

    Create or replace an Instagram comment rule on Studio or Pro. Send every required field on each save. Before enabling it, show the user the account, posts, words and exact message and get their approval for automatic private replies. Returns the saved rule. Replies are sent only once Instagram has approved Spica Post for messages, which is not yet: until then a rule is kept and sends nothing, so tell the user that before they rely on it.

    Show parameters
    • idstringA rule id from autoreplies_list. Leave it out to create a rule.
    • accountIdstringrequiredA connected Instagram account id from accounts_list.
    • mediaIdstringrequiredThe Instagram post or reel id (1 to 32 digits), or "all" for every post and reel on the account.
    • wordsarrayrequired1 to 10 trigger words. Any one matches, ignoring letter case.
    • messagestringrequiredThe private reply text, up to 1000 UTF-8 bytes including links and the optional disclosure line.
    • automatedLinebooleanAppend a blank line and "Automated reply" to the message. Defaults to false.
    • onbooleanrequiredSet true to send automatically on matching comments, or false to keep the rule switched off.
    • brandIdstringThe brand this is for, by its id from brands_list. Needed when the login has more than one brand; with one brand it can be left out.
  • autoreplies_delete2 params

    Remove an Instagram comment rule by id and stop its waiting replies. Returns the removed rule id.

    Show parameters
    • idstringrequiredThe rule id to remove, from autoreplies_list.
    • brandIdstringThe brand this is for, by its id from brands_list. Needed when the login has more than one brand; with one brand it can be left out.
  • links_list1 param

    The user’s link pages: for each its public address, name, line, link buttons in order, what it shows and whether it is live. Also how many pages the plan includes, and `kept`: what the service keeps current on every page without being asked (the look and logo from the brand, the open-now line from the brand’s hours, the connected accounts and the latest published posts). And `reserved`: addresses a page of theirs has left, which only they can use until the time given. The page that carries the user’s blog says so (showBlog) and where the blog is (blogAddress). On Studio and Pro each page has `stats` (null on Starter): visits and link clicks over the last 30 days, today included, and the clicks of each web link on it now (people’s browsers only, no cookies; a phone or email link is not counted). Use it to say which links people use.

    Show parameters
    • brandIdstringThe brand this is for, by its id from brands_list. Needed when the login has more than one brand; with one brand it can be left out.
  • links_save13 params

    Make a link page, or change one: a public page at the app’s address followed by /@handle, with the user’s name, one line about them, their connected accounts as icons and their link buttons. Only what you send changes. The page takes its colours, fonts and logo from the saved brand and keeps the latest posts and the open-now line current by itself, so never add those as links. Starter includes 1 page, Studio 10 and Pro 30; one more is refused. A handle someone else has is refused. With showBlog a page also carries the user’s blog: their articles, at the page’s address followed by /blog.

    Show parameters
    • idstringA page id from links_list, to change that page. Leave out to make a new page.
    • handlestringThe page’s address, after the @: 3 to 30 lowercase letters, digits and hyphens, for example "casa-lola". Needed for a new page. Changing it moves the page: the
    • namestringThe name at the top of the page, up to 60 characters. The business name from the brand when left out.
    • biostringOne line about the business or the person, up to 160 characters. Empty text removes it.
    • linksarrayEvery link button, in the order shown, up to 30. This replaces the list, so send the links from links_list with your change made. To add one link, use addLink.
    • addLinkobjectOne link to add without sending the whole list. It goes first, under the top button. Use it for "add my new video to my link page".
    • accountIdsThe connected accounts this page shows as icons, and whose latest posts it shows, as ids from accounts_list, up to 150. Leave out to keep it as it is; null show
    • showPostsbooleanWhether the page shows the latest published posts (up to three). On for a new page.
    • showHoursbooleanWhether the page says if the business is open now, from the opening hours on the brand. On for a new page; nothing is shown while the brand has no hours.
    • showBlogbooleantrue makes this the page that carries the user’s blog: the articles put on the blog are public at this page’s address followed by /blog, and the page names the
    • hideBrandingbooleantrue removes the “Made with Spica Post” line and generator tag from this link page, its blog and its media kit (Pro). Verified custom domains are always white-l
    • publishedbooleantrue puts the page at its public address; false takes it down. A new page is not published until this is true. Ask the user before publishing.
    • brandIdstringThe brand this is for, by its id from brands_list. Needed when the login has more than one brand; with one brand it can be left out.
  • links_delete2 params

    Remove a link page. Its public address stops working at once. If the page was ever public, the address stays reserved for the user for 30 days, and after that anyone can take it. Nothing that was posted and nothing of the brand is touched.

    Show parameters
    • idstringrequiredA page id from links_list.
    • brandIdstringThe brand this is for, by its id from brands_list. Needed when the login has more than one brand; with one brand it can be left out.
  • links_domain_set3 params

    Connect a custom domain (such as links.yourbusiness.com) to one link page on Pro, enabling white-label serving for the link page (/), its blog (/blog) and its media kit (/media-kit). Returns the DNS TXT ownership record (_spica-verify.<domain>) and CNAME target to add before calling links_domain_verify. Refused if another page already holds the domain. Ask the user before changing a live domain.

    Show parameters
    • idstringrequiredA page id from links_list.
    • domainstringrequiredThe custom domain hostname to connect to this link page, such as "links.yourbusiness.com" or "yourbusiness.com" (Pro). No path, port or wildcard.
    • brandIdstringThe brand this is for, by its id from brands_list. Needed when the login has more than one brand; with one brand it can be left out.
  • links_domain_verify2 params

    Check DNS records (TXT ownership record and CNAME or flattened A/AAAA record) for a link page’s saved custom domain on Pro. Once verified, the custom domain serves the link page, blog and media kit live with white-label branding and canonical URLs.

    Show parameters
    • idstringrequiredA page id from links_list that has a custom domain saved with links_domain_set.
    • brandIdstringThe brand this is for, by its id from brands_list. Needed when the login has more than one brand; with one brand it can be left out.
  • links_domain_remove2 params

    Disconnect the custom domain from a link page immediately so that hostname stops serving the page and becomes available again. The /@handle link page itself stays untouched. Ask the user first.

    Show parameters
    • idstringrequiredA page id from links_list whose custom domain should be disconnected.
    • brandIdstringThe brand this is for, by its id from brands_list. Needed when the login has more than one brand; with one brand it can be left out.
  • short_links_list5 params

    List tracked short links (/l/<code>) for posts and Instagram DMs along with human click counts for the last 7, 30 or 90 days, previous-period comparison, and all-time totals (Studio and Pro). No cookies or visitor data are kept. Changes nothing.

    Show parameters
    • draftIdstringFilter to short links attached to one draft id from drafts_list.
    • postIdstringFilter to short links attached to one published postId.
    • autoreplyRuleIdstringFilter to short links attached to one Instagram auto-reply rule id.
    • daysnumberClick window to sum, counted back from today: 7, 30 or 90 days. 30 when left out.
    • brandIdstringThe brand this is for, by its id from brands_list. Needed when the login has more than one brand; with one brand it can be left out.
  • short_links_save8 params

    Create or update a tracked short link (/l/<code>) for a post caption or Instagram DM auto-reply on Studio or Pro. Put the returned short address in a post or DM to count human clicks (crawlers and link previews still get the 302 redirect so preview cards render, without inflating click counts) and surface per-post clicks in Results.

    Show parameters
    • idstringAn existing short link id from short_links_list to update. Leave out to create a new short link.
    • urlstringThe destination https:// web address the short link redirects visitors to (required when creating a new short link).
    • labelAn optional short label for your own list and Results (up to 80 characters), for example "Spring menu". Pass null or empty string to clear.
    • draftIdOptional draft id from drafts_list to associate this short link with a post. Pass null to unlink.
    • postIdOptional published postId to associate this short link with a specific post. Pass null to unlink.
    • autoreplyRuleIdOptional Instagram auto-reply rule id from autoreplies_list to attribute DM link clicks. Pass null to unlink.
    • activebooleantrue keeps the /l/<code> redirect live; false returns 404 without deleting click history. Defaults to true.
    • brandIdstringThe brand this is for, by its id from brands_list. Needed when the login has more than one brand; with one brand it can be left out.
  • short_links_delete2 params

    Delete a tracked short link and its daily click counts immediately so its /l/<code> address stops redirecting. Ask the user first.

    Show parameters
    • idstringrequiredA short link id from short_links_list to remove along with its click counts.
    • brandIdstringThe brand this is for, by its id from brands_list. Needed when the login has more than one brand; with one brand it can be left out.
  • media_kit_get1 param

    Read the user’s media kit settings, public address (/@handle/media-kit), whether it is live, and the live Results summary currently shown on it.

    Show parameters
    • brandIdstringThe brand this is for, by its id from brands_list. Needed when the login has more than one brand; with one brand it can be left out.
  • media_kit_save13 params

    Configure or publish the user’s public media kit at /@handle/media-kit (Pro). Live performance numbers and best posts come straight from Results on every visit; only the headline, intro, sponsor contact, period, visibility switches and optional audience or package rows are saved here. Ask the user before publishing.

    Show parameters
    • publishedbooleantrue puts the media kit live at /@handle/media-kit; false takes it down. Ask the user before publishing.
    • handlestringWhich of the user’s link page handles hosts the media kit. Leave out to use the blog page or first live link page.
    • headlinestringHeadline at the top of the media kit, up to 120 characters. Leave empty to use the link page name.
    • aboutstringShort introduction for sponsors, up to 400 characters. Leave empty to use the link page bio.
    • contactstringSponsor contact link: an https:// page, mailto: email or tel: phone number, up to 500 characters. Leave empty to hide the contact button.
    • contactLabelstringWords on the contact button, up to 40 characters. Defaults to "Get in touch".
    • daysintegerLive results window to display: 30 or 90 days. Defaults to 30.
    • showNetworksbooleanShow the per-network performance table and connected accounts. Defaults to true.
    • showBestPostsbooleanShow the top-performing posts from Results with links. Defaults to true.
    • showTopicsbooleanShow the brand’s topics and top hashtags. Defaults to true.
    • audiencearrayOptional self-reported audience numbers, up to 8 rows, shown as self-reported since follower counts are not collected automatically.
    • packagesarrayOptional sponsor offerings or rate rows, up to 6 items.
    • brandIdstringThe brand this is for, by its id from brands_list. Needed when the login has more than one brand; with one brand it can be left out.
  • topics_list1 param

    The topic ledger: every topic planned or covered, with where it stands on each network and in each language.

    Show parameters
    • brandIdstringThe brand this is for, by its id from brands_list. Needed when the login has more than one brand; with one brand it can be left out.
  • topics_add7 params

    Add a topic to the ledger before writing it: its title, the question or search phrase it is meant to win (keyword), the one product or service it is about (item), how it comes at it (angle) and which of the brand’s topics it belongs to (pillar). A keyword already covered is refused, so the same question is never written twice.

    Show parameters
    • titlestringrequiredThe topic in a few words, up to 160 characters.
    • keywordstringThe question or search phrase it is meant to win, up to 120 characters. One already covered is refused.
    • itemstringThe one product or service it is about, up to 120 characters.
    • anglestringHow the piece comes at it, in a word or two of up to 60 characters: guide, comparison, checklist, story.
    • pillarstringWhich of the brand’s topics it belongs to, up to 120 characters.
    • notestringAnything to remember when writing it, up to 400 characters.
    • brandIdstringThe brand this is for, by its id from brands_list. Needed when the login has more than one brand; with one brand it can be left out.
  • topics_update8 params

    Update an existing topic’s title, keyword, item, angle, pillar or note without removing its linked drafts. Only the fields you send change; an empty string or null clears an optional field. A keyword already covered by another topic is refused.

    Show parameters
    • idstringrequiredA topic id from topics_list or topics_add.
    • titlestringUpdated topic title, up to 160 characters.
    • keywordUpdated search phrase, up to 120 characters. Empty text or null clears it. One already covered by another topic is refused.
    • itemUpdated product or service, up to 120 characters. Empty text or null clears it.
    • angleUpdated angle, up to 60 characters. Empty text or null clears it.
    • pillarUpdated brand pillar, up to 120 characters. Empty text or null clears it.
    • noteUpdated note to remember when writing it, up to 400 characters. Empty text or null clears it.
    • brandIdstringThe brand this is for, by its id from brands_list. Needed when the login has more than one brand; with one brand it can be left out.
  • topics_link4 params

    Tie a draft to its topic, with the language it is written in. Do this for every draft you create, so the ledger knows what was written and posted.

    Show parameters
    • idstringrequiredA topic id from topics_add or topics_list.
    • draftIdstringrequiredThe draft written for it.
    • languagestringThe language the draft is written in.
    • brandIdstringThe brand this is for, by its id from brands_list. Needed when the login has more than one brand; with one brand it can be left out.
  • topics_remove2 params

    Take a planned topic out of the ledger. A topic with a post out cannot be removed.

    Show parameters
    • idstringrequiredA topic id from topics_list.
    • brandIdstringThe brand this is for, by its id from brands_list. Needed when the login has more than one brand; with one brand it can be left out.
  • coverage_get1 param

    What is covered and what is not: each topic’s standing per network and language, what it still lacks, how many topics each brand pillar has, and the profile questions no topic has taken yet. Call it to choose what to write next.

    Show parameters
    • brandIdstringThe brand this is for, by its id from brands_list. Needed when the login has more than one brand; with one brand it can be left out.
  • keywords_research4 params

    Local keyword research: how many times a month people in one city search for the terms you give, and for the closest related searches, from Google’s own counts. Each answer lists the terms asked first, then up to 50 related ones, most searched first, each with searchesPerMonth (null when too few to count), competition among advertisers (low, medium, high), adClickPrice (what an advertiser pays for one click, in US dollars: a sign of how much the search is worth) and the last 12 months as trend. Use it when choosing topics: give the business’s main products or services in the customer’s words and the city from the brand, then take the strongest terms as topic keywords (topics_add). Each call uses one of the plan’s lookups for the month (Studio 20, Pro 200; usage_get says how many are left under keywords). Lookups are kept: read one again with keywords_list instead of asking twice.

    Show parameters
    • termsarrayrequiredOne to 10 search terms in the words a customer would type, such as "wedding flowers" or "florist". At most 80 characters and 10 words each, no emoji.
    • placestringrequiredThe city the business serves, with its state or country, such as "Austin, Texas" or "Bogotá, Colombia". A state or a whole country works too, with fewer local n
    • languagestringThe language people search in: en (English) or es (Spanish). English when left out.
    • brandIdstringThe brand this is for, by its id from brands_list. Needed when the login has more than one brand; with one brand it can be left out.
  • keywords_list2 params

    The keyword lookups this workspace made, newest first, each with its three most searched terms; or, with an id, one lookup in full. Reading uses no lookup. Changes nothing.

    Show parameters
    • idstringA lookup id from keywords_list, for that lookup in full. Leave it out for the list.
    • brandIdstringThe brand this is for, by its id from brands_list. Needed when the login has more than one brand; with one brand it can be left out.
  • playbook_get2 params

    How to write a post for each network: what one post is, how its caption is built, where a link goes, and the rules every post follows. Read it before writing a set of posts. Without a network it answers for the connected ones.

    Show parameters
    • networkstringOne network key, such as instagram. Leave out for every connected network.
    • brandIdstringThe brand this is for, by its id from brands_list. Needed when the login has more than one brand; with one brand it can be left out.
  • grader_get2 params

    How to judge a draft before the user sees it: seven scored dimensions for an article, yes-or-no checks for a social post, and what counts as a pass. Judge every piece and fix it until it passes.

    Show parameters
    • kindstringWhat is being judged.
    • brandIdstringThe brand this is for, by its id from brands_list. Needed when the login has more than one brand; with one brand it can be left out.
  • calendars_list1 param

    Read the workspace’s live iCalendar (.ics) and Google Sheets (.csv) subscription feed status, feed addresses when enabled, and synced external .ics calendars (Studio and Pro). Changes nothing.

    Show parameters
    • brandIdstringThe brand this is for, by its id from brands_list. Needed when the login has more than one brand; with one brand it can be left out.
  • calendars_feed_set3 params

    Turn the workspace’s live iCalendar (.ics) and Google Sheets (.csv) subscription feed on or off, or rotate its secret token (Studio and Pro). Ask the user before rotating, because rotating breaks previously subscribed calendar links.

    Show parameters
    • enabledbooleantrue turns the live .ics and Google Sheets .csv subscription feed on; false turns it off.
    • rotatebooleantrue generates a fresh secret feed token and immediately invalidates the old feed links.
    • brandIdstringThe brand this is for, by its id from brands_list. Needed when the login has more than one brand; with one brand it can be left out.
  • calendars_external_save6 params

    Add or update an external .ics or webcal:// calendar (Google Calendar, Outlook, Apple Calendar) and sync its events onto the Spica Post calendar (Studio and Pro, up to 5 per workspace).

    Show parameters
    • idstringAn existing synced calendar id from calendars_list to update. Leave out to add a new external calendar.
    • namestringA short name for this external calendar, up to 80 characters, such as "Client Launches".
    • urlstringThe public or secret https:// or webcal:// iCalendar (.ics) address, up to 2048 characters. Required when adding a new calendar.
    • colorstringA dot colour hex from the supported palette.
    • enabledbooleanfalse hides the external calendar’s events without removing it.
    • brandIdstringThe brand this is for, by its id from brands_list. Needed when the login has more than one brand; with one brand it can be left out.
  • calendars_external_sync2 params

    Refresh one or all enabled external .ics calendars on demand so newly added launches or events appear on the calendar right away (Studio and Pro).

    Show parameters
    • idstringOne external calendar id from calendars_list to refresh. Leave out to refresh every enabled external calendar.
    • brandIdstringThe brand this is for, by its id from brands_list. Needed when the login has more than one brand; with one brand it can be left out.
  • calendars_external_delete2 params

    Remove a synced external .ics calendar and its cached events from this workspace. Ask the user first.

    Show parameters
    • idstringrequiredAn external calendar id from calendars_list to remove.
    • brandIdstringThe brand this is for, by its id from brands_list. Needed when the login has more than one brand; with one brand it can be left out.
  • review_links_list1 param

    List shareable zero-login client review calendar links (/review/<token>) for this workspace, their status, expiry, location scope and recent client approvals or change-request notes. Changes nothing.

    Show parameters
    • brandIdstringThe brand this is for, by its id from brands_list. Needed when the login has more than one brand; with one brand it can be left out.
  • review_links_save8 params

    Create or update a shareable zero-login client review and approval calendar link (/review/<token>, up to 20 per workspace on Studio and Pro) so clients can inspect scheduled posts and click Approve or Request changes without an account.

    Show parameters
    • idstringAn existing review link id from review_links_list to update. Leave out to create a new link.
    • titlestringTitle shown on the client review page, up to 100 characters, such as "December Content Calendar".
    • clientNamestringOptional client or stakeholder name shown on the review page, up to 80 characters.
    • locationIdOptional location id from locations_list to scope the review calendar to one location or client.
    • allowFeedbackbooleantrue lets the client approve or request changes with notes on posts. Defaults to true.
    • expiresInDaysOptional number of days (1 to 365) until the link expires, or null for no expiry.
    • enabledbooleanfalse pauses the link without deleting it.
    • brandIdstringThe brand this is for, by its id from brands_list. Needed when the login has more than one brand; with one brand it can be left out.
  • review_links_delete2 params

    Revoke a shareable client review link immediately so its public URL stops working, and remove its feedback records. Ask the user first.

    Show parameters
    • idstringrequiredA client review link id from review_links_list to revoke.
    • brandIdstringThe brand this is for, by its id from brands_list. Needed when the login has more than one brand; with one brand it can be left out.
  • team_settings_get1 param

    Read this workspace’s team governance settings: whether posts require internal approval before publishing (requireApproval), seat limits and available roles. Check this before publishing in a team workspace. Changes nothing.

    Show parameters
    • brandIdstringThe brand this is for, by its id from brands_list. Needed when the login has more than one brand; with one brand it can be left out.
  • team_settings_set2 params

    Turn required internal approval before publishing on or off for this workspace (Studio and Pro, admins and owners only). Ask the user before changing workspace approval rules.

    Show parameters
    • requireApprovalbooleanrequiredtrue requires internal approval before non-owners can publish or schedule; false allows direct publishing.
    • brandIdstringThe brand this is for, by its id from brands_list. Needed when the login has more than one brand; with one brand it can be left out.
  • team_members_list1 param

    List team members, their roles (owner, admin, editor, viewer), pending invitations and seat limits for this workspace (Studio and Pro). Changes nothing.

    Show parameters
    • brandIdstringThe brand this is for, by its id from brands_list. Needed when the login has more than one brand; with one brand it can be left out.
  • team_invite3 params

    Invite a teammate to this workspace by email with a role-bound 7-day /invite/<token> link (Studio up to 3 seats, Pro up to 15 seats). Sends the invitation email automatically when mail is configured and returns the invite link as well. Ask the user for the exact email and role first.

    Show parameters
    • emailstringrequiredEmail address of the teammate to invite, up to 200 characters.
    • rolestringWorkspace role for the invited teammate: "admin", "editor" or "viewer". Defaults to "editor".
    • brandIdstringThe brand this is for, by its id from brands_list. Needed when the login has more than one brand; with one brand it can be left out.
  • team_invite_revoke2 params

    Revoke a pending workspace team invitation so its invite link stops working immediately. Ask the user first.

    Show parameters
    • idstringrequiredPending invitation id from team_members_list to revoke.
    • brandIdstringThe brand this is for, by its id from brands_list. Needed when the login has more than one brand; with one brand it can be left out.
  • team_role_set3 params

    Change an existing workspace teammate’s role (admin, editor or viewer) on Studio or Pro. Ask the user before changing a teammate’s permissions.

    Show parameters
    • userIdstringrequiredTeammate userId from team_members_list.
    • rolestringrequiredNew workspace role for this teammate: "admin", "editor" or "viewer".
    • brandIdstringThe brand this is for, by its id from brands_list. Needed when the login has more than one brand; with one brand it can be left out.
  • team_member_remove2 params

    Remove a teammate from this workspace immediately so they can no longer access this brand. Ask the user first.

    Show parameters
    • userIdstringrequiredTeammate userId from team_members_list to remove from this workspace.
    • brandIdstringThe brand this is for, by its id from brands_list. Needed when the login has more than one brand; with one brand it can be left out.
  • approvals_list4 params

    List internal approval queue requests for this workspace (social drafts and blog articles; pending, approved, changes_requested or cancelled), newest first, with details, target mode, scheduled time and reviewer notes. Changes nothing.

    Show parameters
    • statusstringFilter internal approval requests by status. Defaults to all.
    • kindstringFilter by content kind: all, draft (social posts) or article (blog articles). Defaults to all.
    • limitintegerMaximum approval requests to return (1 to 200). Defaults to 50.
    • brandIdstringThe brand this is for, by its id from brands_list. Needed when the login has more than one brand; with one brand it can be left out.
  • approvals_submit7 params

    Submit a validated social draft (draftId) or blog article (articleId) to the workspace’s internal approval queue with an optional note for reviewers, instead of publishing directly. Nothing goes live until an admin or owner approves it.

    Show parameters
    • draftIdstringValidated social draft id from drafts_list or drafts_create to submit for approval. Send either draftId or articleId.
    • articleIdstringArticle id from articles_list or articles_save to submit for blog publishing approval. Send either draftId or articleId.
    • versionintegerExpected draft or article version as last read. Refused if it changed.
    • modestringAction to run automatically once approved: publish, schedule or queue (queue is for social drafts only). Defaults to publish.
    • scheduledAtstringFuture UTC ISO timestamp when mode is schedule (social schedule time or blog publishAt).
    • notestringOptional context note for the reviewer, up to 500 characters.
    • brandIdstringThe brand this is for, by its id from brands_list. Needed when the login has more than one brand; with one brand it can be left out.
  • approvals_decide4 params

    Approve (which immediately publishes, schedules or queues the social draft, or publishes/schedules the blog article onto the blog) or request changes on a pending internal approval request. Call with decision: "approved" only after the user explicitly approves it.

    Show parameters
    • idstringrequiredPending approval request id from approvals_list.
    • decisionstringrequired"approved" publishes or schedules the social post or blog article immediately; "changes_requested" sends it back with your note.
    • notestringOptional reviewer feedback note, up to 500 characters.
    • brandIdstringThe brand this is for, by its id from brands_list. Needed when the login has more than one brand; with one brand it can be left out.
  • approvals_cancel2 params

    Withdraw a pending internal approval request without publishing or deleting the draft or article. Ask the user first.

    Show parameters
    • idstringrequiredPending approval request id from approvals_list to withdraw.
    • brandIdstringThe brand this is for, by its id from brands_list. Needed when the login has more than one brand; with one brand it can be left out.
  • audit_list4 params

    Read and search the workspace’s audit log (publishing, approvals, team, integrations and workspace actions), newest first. Changes nothing.

    Show parameters
    • categorystringFilter audit log entries by category. Defaults to all.
    • qstringOptional search query across actor, action, target and detail, up to 100 characters.
    • limitintegerMaximum audit entries to return (1 to 500). Defaults to 100.
    • brandIdstringThe brand this is for, by its id from brands_list. Needed when the login has more than one brand; with one brand it can be left out.
  • brands_approvals_list2 params

    Read internal draft approval requests and recent external client review feedback across every brand this login holds in one call, newest first and tagged with brandId and brandName. Ideal for agencies triaging approvals across all clients. Changes nothing.

    Show parameters
    • statusstringFilter internal approval requests across every brand by status. Defaults to pending.
    • limitintegerMaximum approval requests to return across all brands (1 to 200). Defaults to 50.
  • webhooks_list1 param

    List signed webhook endpoints for this workspace: each endpoint’s address, subscribed events, enabled state and last delivery status. Never returns the signing secret. Changes nothing.

    Show parameters
    • brandIdstringThe brand this is for, by its id from brands_list. Needed when the login has more than one brand; with one brand it can be left out.
  • webhooks_save6 params

    Add or update a signed webhook endpoint (up to 5 per workspace on paid plans) to push post, draft, review, approval and account events to Slack, Zapier, Make or your own HTTPS server. When adding a new endpoint, the response includes its whsec_ signing secret once: tell the user to save it securely. Ask the user before adding or changing an endpoint.

    Show parameters
    • idstringAn existing webhook id from webhooks_list to update. Leave out to add a new endpoint (up to 5 per workspace).
    • urlstringThe public https:// address events are sent to, up to 2048 characters. Required when adding a new endpoint.
    • eventsarrayWhich events to send: post.scheduled, post.rescheduled, post.published, post.failed, post.needs_check, post.cancelled, draft.created, draft.updated, review.subm
    • descriptionstringOptional note for your own list, up to 120 characters.
    • enabledbooleanfalse pauses sending to this endpoint; true resumes it.
    • brandIdstringThe brand this is for, by its id from brands_list. Needed when the login has more than one brand; with one brand it can be left out.
  • webhooks_delete2 params

    Remove a webhook endpoint and cancel any pending event deliveries for it. Ask the user first.

    Show parameters
    • idstringrequiredA webhook id from webhooks_list to remove.
    • brandIdstringThe brand this is for, by its id from brands_list. Needed when the login has more than one brand; with one brand it can be left out.
  • webhooks_test2 params

    Send a signed ping event to a webhook endpoint right away so the receiver can verify its Spica-Signature header. Check the outcome with webhooks_events.

    Show parameters
    • idstringrequiredA webhook id from webhooks_list to send a signed ping event to.
    • brandIdstringThe brand this is for, by its id from brands_list. Needed when the login has more than one brand; with one brand it can be left out.
  • webhooks_events3 params

    Read recent webhook deliveries for one endpoint, newest first: event type, attempt count, last HTTP status and next retry time. Changes nothing.

    Show parameters
    • idstringrequiredA webhook id from webhooks_list.
    • limitintegerMaximum recent webhook deliveries to return (1 to 100), newest first. Defaults to 20.
    • brandIdstringThe brand this is for, by its id from brands_list. Needed when the login has more than one brand; with one brand it can be left out.
  • export_schedule5 params

    Export scheduled and published posts as formula-safe RFC 4180 CSV ready for Excel or Google Sheets (Studio and Pro). Changes nothing.

    Show parameters
    • fromstringOptional ISO date or timestamp; only posts at or after this time are included.
    • tostringOptional ISO date or timestamp; only posts at or before this time are included.
    • statusstringFilter exported posts by status. Defaults to all non-cancelled posts.
    • locationIdstringOptional location id from locations_list to filter exported posts to one location.
    • brandIdstringThe brand this is for, by its id from brands_list. Needed when the login has more than one brand; with one brand it can be left out.
  • export_results3 params

    Export published post performance metrics (likes, comments, shares, views and reach) as formula-safe RFC 4180 CSV (Studio and Pro). Changes nothing.

    Show parameters
    • daysintegerHow many past days to include (1 to 365). Defaults to 30.
    • locationIdstringOptional location id from locations_list to filter exported results to one location.
    • brandIdstringThe brand this is for, by its id from brands_list. Needed when the login has more than one brand; with one brand it can be left out.
  • export_locations2 params

    Export per-location performance rollups for 7, 30 or 90 days as formula-safe RFC 4180 CSV (Pro). Changes nothing.

    Show parameters
    • daysintegerHow many past days to include: 7, 30 or 90. Defaults to 30.
    • brandIdstringThe brand this is for, by its id from brands_list. Needed when the login has more than one brand; with one brand it can be left out.
  • export_audit3 params

    Export the workspace audit log as formula-safe RFC 4180 CSV (Studio and Pro). Changes nothing.

    Show parameters
    • categorystringFilter exported audit log entries by category. Defaults to all.
    • qstringOptional search query across actor, action, target and detail, up to 100 characters.
    • brandIdstringThe brand this is for, by its id from brands_list. Needed when the login has more than one brand; with one brand it can be left out.

Checked by Serverdex with a plain initialize + tools/list call to app.spicapost.com/mcp, no credentials, about once a day. A failed check is never a removal.

On GitHub

read Nov 19, 2026
Stars
0
Forks
0
Last push
Nov 19, 2026
License
—

ai-agentschatgptclaudemcpmcp-servermodel-context-protocolremote-mcpsocial-mediasocial-media-scheduler

From the README

Spica Post MCP server Spica Post is a social media scheduler for small businesses and creators. This is its hosted MCP server: connect Claude, ChatGPT, Gemini, Cursor or any MCP client, tell it what's happening this week, and it drafts a post for each of your social accounts, checks each against that network's rules, and schedules or publishes it once you approve. • Endpoint: https://app.spicapost.com/mcp (remote, streamable HTTP) • Sign-in: OAuth with discovery and automatic client registration. No API key, nothing to install. • Website: https://spicapost.com · Full tool reference: https://spicapost.com/reference/ • Registry name: com.spicapost/spica-post in the official MCP Registry Networks: X, LinkedIn and Bluesky today. Instagram, Facebook, Threads, Google Business Profile, YouTube and TikTok are built and switch on as each network approves the app. Connect Claude (web and desktop): Settings → Connectors → Add custom connector → paste https://app.spicapost.com/mcp. Guide ChatGPT: add it as a connector with the same address. Guide Claude Code Codex Cursor, VS Code and other JSON-configured clients The first call opens the Spica Post sign-in in your browser. Sign in (or create your account) and press Allow. Until then every call answers 401.…

Read the full README on GitHub →

Remotes

  • streamable-httphttps://app.spicapost.com/mcp

The most-starred Communication servers in the index, with their live-check result.

ServerStarsLast pushLive check
Inbox Zero13,088Nov 2026Needs sign-in
Agent-Native Brain7,735Nov 2026Needs sign-in
Agent-Native Mail7,735Nov 2026Needs sign-in
Agent-Native Chat7,735Nov 2026Needs sign-in
Agent-Native Dispatch7,735Nov 2026Needs sign-in

Spica Post: questions people ask

Is Spica Post a remote or a local MCP server?
According to its entry in the official MCP registry, Spica Post ships as a hosted endpoint (streamable-http) that your client connects to by URL.
Does Spica Post need an API key?
Its hosted endpoint completed the Serverdex live check — an MCP initialize + tools/list call — with no credentials on Nov 22, 2026. Individual tools may still ask for a key when called.
Is Spica Post safe to use?
Mostly fine: Spica Post is maintained, hosted endpoint answering without a key. In detail — maintained: Active; official registry: Active; source: No licence found; runs: Hosted by the publisher; credentials: None needed to connect. Serverdex check of Nov 22, 2026. This is a reading of the repository, the registry entry and the live check, not a code audit; run the Serverdex security scan on the endpoint before trusting it with real data.
Is Spica Post still maintained?
Active: the repository's last commit 3 days ago. Last push Nov 19, 2026, 0 GitHub stars. Read from GitHub on Nov 19, 2026.
What tools does Spica Post expose?
133 tools as listed by the server itself during the live check, including accounts_list, accounts_connect, site_study, posts_recent, capabilities. The full list with parameters is in the Live check section above.
How do I add Spica Post to Claude, Cursor or VS Code?
Copy the config in "Connect this server" into your client's MCP config file (claude_desktop_config.json, ~/.cursor/mcp.json or .vscode/mcp.json), or use the one-click Add to Cursor / Add to VS Code buttons and the one-line commands for Claude Code and Codex; then restart the client.
Browse all Communication →

Add the badge to your site

Show visitors that Spica Post is listed here — it’s also the link we check for a free listing.

Spica Post — listed on Serverdex

HTML — for your website

<a href="https://serverdex.io/server/com-spicapost-spica-post?utm_source=badge"><img src="https://serverdex.io/brand/badge.svg" alt="Spica Post — listed on Serverdex" width="123" height="40" loading="lazy"></a>

Recommended. A dofollow link from your own domain is the one that counts for search engines, and it's the link we check for a free listing.

Markdown — for your README

[![Spica Post — listed on Serverdex](https://serverdex.io/brand/badge.svg)](https://serverdex.io/server/com-spicapost-spica-post?utm_source=badge)

Nice for visibility, but GitHub marks README links nofollow, so it doesn't pass authority. Use the HTML badge on your site as well.

Add to CursorAdd to VS CodeOpen in Claude Code

Install buttons — for your README

[![Add to Cursor](https://serverdex.io/brand/install-cursor.svg)](https://serverdex.io/install/cursor/com-spicapost-spica-post) [![Add to VS Code](https://serverdex.io/brand/install-vscode.svg)](https://serverdex.io/install/vscode/com-spicapost-spica-post) [![Open in Claude Code](https://serverdex.io/brand/install-claude-code.svg)](https://serverdex.io/install/claude-code/com-spicapost-spica-post)

One click opens Cursor or VS Code with this server's config prefilled; the Claude Code button lands on the one-line command. The links point at Serverdex, so when your config changes the buttons keep working.

Install buttons — HTML for your docs

<a href="https://serverdex.io/install/cursor/com-spicapost-spica-post"><img src="https://serverdex.io/brand/install-cursor.svg" alt="Add to Cursor — via Serverdex" width="140" height="28"></a>
<a href="https://serverdex.io/install/vscode/com-spicapost-spica-post"><img src="https://serverdex.io/brand/install-vscode.svg" alt="Add to VS Code — via Serverdex" width="147" height="28"></a>
<a href="https://serverdex.io/install/claude-code/com-spicapost-spica-post"><img src="https://serverdex.io/brand/install-claude-code.svg" alt="Open in Claude Code — via Serverdex" width="180" height="28"></a>

Same buttons as plain links for a docs page or website.

Prefer a live badge with the score, stars and live check? Score badge (links to a page that explains the number and back to this listing).