Use casesFor AI agents
Give your agent the ability to publish
An agent that can write a post should be able to publish it, check that it went out and read how it did. Siar ships an MCP server and a CLI that return JSON, so agents can use it without glue code.
- MCP server for Claude, Cursor and any MCP client.
- CLI with JSON on stdout and distinct exit codes, plus a SKILL.md for agent runtimes.
- A generic
callescape hatch reaches every operation by its operationId. - X costs are quoted before they are incurred.
MCP server
Add the server to your MCP client with an API key. It exposes tools for teams, accounts, uploads, posts, comments, analytics, usage and X credit, plus call_operation for everything else.
{
"mcpServers": {
"siar": {
"command": "npx",
"args": ["-y", "@siar/mcp"],
"env": { "SIAR_API_KEY": "sk_live_..." }
}
}
}CLI for shells, CI and agents
Every command prints JSON, sends progress to stderr and uses exit codes an agent can branch on: usage, auth, not found, validation, rate limited, server error.
npm i -g @siar/cli
export SIAR_API_KEY=sk_live_...
siar teams:list
siar accounts:list --team TEAM_ID
siar posts:create --team TEAM_ID --networks BLUESKY,MASTODON --text "Shipped" --now
siar posts:get POST_ID
siar helpGuard rails you can rely on
Quotas, daily caps and per-network validation apply to agents exactly as to any client, so a runaway loop hits a documented limit and not a network's spam filter. For X, the credit tools show the balance and quote the cost of an action first.
Works with every supported network
Frequently asked questions
Which MCP tools are available?
Listing and creating teams, listing accounts and getting a connect URL, uploading media, creating and scheduling posts, listing, reading, retrying and deleting posts, comments and replies, post and account analytics, usage, X credit balance and quote, and a generic operation call.
Can the agent post to a real account by mistake?
It can do anything its API key can do. Use a draft status, a dedicated team connected to a test account, or review before scheduling while you build confidence.
Is there a plain-text description of the site for LLMs?
Yes: /llms.txt and /pricing.md.
Keep reading
Your first post isone request away.
The Free plan includes 20 posts and 200 uploads a month across 3 teams. No card needed.