# Chirpie Documentation
# Base URL: https://chirpie.ai
# Append .md to any doc URL for raw markdown

> Chirpie lets AI agents and developers publish to X, Bluesky, LinkedIn, Threads, Mastodon, Instagram, Facebook and Telegram: posts, threads, scheduling, media, comments and analytics.

## Connect
- [Claude Connectors Directory listing](https://claude.ai/directory/chirpie): Chirpie is listed in the Claude Connectors Directory. Add it from the listing in claude.ai or Claude Desktop and sign in; no URL to paste.
- [Hosted MCP server](https://chirpie.ai/docs/mcp.md): https://chirpie.ai/mcp, OAuth sign-in with a Full access or Read only choice, or an API key. Works in ChatGPT developer mode, Meta Muse, Cursor, Claude Code and any remote MCP client.
- [Local MCP server](https://chirpie.ai/docs/mcp.md): the @chirpie/mcp npm package runs the same tools over stdio.
- [REST API](https://chirpie.ai/docs/api/posts.md): https://chirpie.ai/api/v1 with a chirpie_sk_ API key, plus the @chirpie/sdk TypeScript SDK, the chirpie CLI and an n8n community node.

## Docs
- [Authentication](https://chirpie.ai/docs/authentication.md): How to authenticate with the Chirpie API using API keys, and how to narrow a key with scopes.
- [When a connection dies](https://chirpie.ai/docs/connection-dies.md): How Chirpie tells you a social account stopped accepting posts, what happens to anything you had scheduled on it, and how to get back to publishing.
- [Error Codes](https://chirpie.ai/docs/errors.md): Reference for all Chirpie API error codes and how to handle them.
- [Idempotency](https://chirpie.ai/docs/idempotency.md): Retry a post, thread, upload or comment safely with an Idempotency-Key, so a timeout or a network blip does not publish the same thing twice. Keys are remembered for 24 hours.
- [Getting Started](https://chirpie.ai/docs/index.md): Get up and running with Chirpie in under 2 minutes.
- [Post to several accounts at once](https://chirpie.ai/docs/multi-account.md): Send one request to many connected accounts, with per-account text and media, and read the whole fan-out back by its group id.
- [n8n](https://chirpie.ai/docs/n8n.md): Post to X, Bluesky, LinkedIn, Threads, Mastodon, Instagram, Facebook, and Telegram from an n8n workflow with the @chirpie/n8n-nodes-chirpie community node, covering posting, threads, scheduling, accounts, analytics, and AI Agent tool use.
- [Rate Limits & Pricing](https://chirpie.ai/docs/rate-limits.md): What Chirpie costs, monthly post quotas, per-post overage rates, the X link-post charge, burst limits, and how to handle rate limiting.
- [Scheduling](https://chirpie.ai/docs/scheduling.md): Schedule posts and threads for future publishing on X, Bluesky, LinkedIn, Threads, Mastodon, Instagram, Facebook, and Telegram, and save drafts to finish later.
- [Bring Your Own X Keys](https://chirpie.ai/docs/x-byo-keys.md): Connect X accounts through your own X developer app so posts use your X API credits, and skip Chirpie's X link-post surcharge.
- [Accounts](https://chirpie.ai/docs/api/accounts.md): List and connect the X/Twitter, Bluesky, LinkedIn, Threads, Mastodon, Instagram, Facebook, and Telegram accounts you post through with Chirpie.
- [Analytics](https://chirpie.ai/docs/api/analytics.md): Retrieve engagement metrics for published posts.
- [Comments](https://chirpie.ai/docs/api/comments.md): List the comments on a post you published, reply to one, hide it, or delete it.
- [API Keys](https://chirpie.ai/docs/api/keys.md): Create, list, and revoke API keys programmatically, and narrow a key with scopes.
- [Media](https://chirpie.ai/docs/api/media.md): Upload images and videos, attach them to posts, and describe them with alt text.
- [Posts](https://chirpie.ai/docs/api/posts.md): Create, save as a draft, list, retrieve, edit, and delete posts via the Chirpie API, and publish a first comment under a post.
- [Threads](https://chirpie.ai/docs/api/threads.md): Create multi-post threads that publish as connected replies on X, Bluesky, Threads, Mastodon, and Telegram, or as standalone posts on LinkedIn, Instagram, and Facebook.
- [CLI Commands](https://chirpie.ai/docs/cli/commands.md): Complete reference for all Chirpie CLI commands.
- [CLI Overview](https://chirpie.ai/docs/cli.md): Install and authenticate the Chirpie command-line interface.
- [Build a Telegram Announcement Bot with the SDK](https://chirpie.ai/docs/guides/build-a-telegram-announcement-bot-with-the-sdk.md): Use @chirpie/sdk to push deploy notices, changelogs, and release announcements into a Telegram channel from your own code.
- [Cross-Post One Update to 8 Networks from Cursor](https://chirpie.ai/docs/guides/cross-post-to-8-networks-from-cursor.md): Configure the Chirpie MCP server in Cursor and fan a single announcement out to X, Bluesky, LinkedIn, Threads, Mastodon, Instagram, Facebook, and Telegram in one pass.
- [Give Your OpenClaw Agent a Social Media Account](https://chirpie.ai/docs/guides/give-your-openclaw-agent-a-social-media-account.md): Install the Chirpie skill in OpenClaw, or connect the MCP server, so your agent can post to X, Bluesky, LinkedIn, Mastodon and more.
- [Post to Bluesky and Mastodon from Claude Code](https://chirpie.ai/docs/guides/post-to-bluesky-and-mastodon-from-claude-code.md): Wire the Chirpie MCP server into Claude Code so you can post to Bluesky and Mastodon without leaving your terminal.
- [Post to Instagram from an AI Agent](https://chirpie.ai/docs/guides/post-to-instagram-from-an-ai-agent.md): How to let an AI agent publish Instagram posts and carousels through the Chirpie API, including the image requirement.
- [Post to Social Media from n8n](https://chirpie.ai/docs/guides/post-to-social-media-from-n8n.md): Use the n8n HTTP Request node to publish to X, Bluesky, LinkedIn, and more through the Chirpie API, with an importable workflow.
- [Post to X from Claude](https://chirpie.ai/docs/guides/post-to-x-from-claude.md): Let Claude post to X (Twitter) through Chirpie, added from the Claude Connectors Directory, by the hosted MCP endpoint, or in Claude Code.
- [Schedule a Week of LinkedIn Posts with an Agent](https://chirpie.ai/docs/guides/schedule-a-week-of-linkedin-posts-with-an-agent.md): Have an AI agent draft and schedule five LinkedIn posts in one pass using the Chirpie scheduling API.
- [Use Chirpie with ChatGPT](https://chirpie.ai/docs/mcp/chatgpt.md): Add https://chirpie.ai/mcp to ChatGPT as a developer-mode app, or to the OpenAI Responses API, and let it publish and schedule posts to X, LinkedIn and more.
- [Use Chirpie with Claude](https://chirpie.ai/docs/mcp/claude.md): Add Chirpie from the Claude Connectors Directory, or add https://chirpie.ai/mcp to Claude Code, and let Claude publish, schedule and track posts.
- [MCP Server](https://chirpie.ai/docs/mcp.md): The publishing connector for AI agents. Connect Claude, Cursor, ChatGPT or Muse to Chirpie with one URL and post to X, Bluesky, LinkedIn, Threads, Mastodon, Instagram, Facebook and Telegram.
- [Use Chirpie with Meta Muse](https://chirpie.ai/docs/mcp/meta-muse.md): Add Chirpie to Meta Muse as a custom connector so Muse can publish and schedule posts to X, LinkedIn, Bluesky, Threads, Mastodon, Instagram, Facebook and Telegram.
- [Bluesky API for AI agents](https://chirpie.ai/docs/platforms/bluesky.md): Let an AI agent post, thread, schedule and read replies on Bluesky through one Chirpie API key or MCP tool, connected with a Bluesky app password.
- [Schedule Facebook Page posts with an AI agent](https://chirpie.ai/docs/platforms/facebook.md): How Chirpie lets an AI agent publish and schedule Facebook Page posts and stories, attach link previews, answer comments and read results.
- [Google Business Profile posting API for AI agents](https://chirpie.ai/docs/platforms/google-business-profile.md): How Chirpie lets an AI agent publish Google Business Profile updates from one API call or an MCP tool, with an optional photo and scheduling.
- [Instagram API for AI agents](https://chirpie.ai/docs/platforms/instagram.md): How Chirpie lets an AI agent publish Instagram feed posts, carousels, stories and reels, schedule them, answer comments and read views.
- [LinkedIn API for AI agents](https://chirpie.ai/docs/platforms/linkedin.md): Let an AI agent publish and schedule LinkedIn posts with images through one Chirpie API key or MCP tool, with no LinkedIn developer app of your own.
- [Mastodon API for AI agents](https://chirpie.ai/docs/platforms/mastodon.md): Let an AI agent post, thread, schedule and answer replies on any Mastodon server through one Chirpie API key or MCP tool.
- [Pinterest API for AI agents](https://chirpie.ai/docs/platforms/pinterest.md): How Chirpie lets an AI agent publish Pinterest pins from one API call or an MCP tool, with an image, a title and scheduling.
- [Telegram channel posting API for AI agents](https://chirpie.ai/docs/platforms/telegram.md): Let an AI agent post, thread and schedule messages in a Telegram channel or group through one Chirpie API key or MCP tool, using your own bot.
- [Threads API for AI agents](https://chirpie.ai/docs/platforms/threads.md): How Chirpie lets an AI agent post, thread, schedule and answer replies on Meta's Threads through one REST API or the Chirpie MCP server.
- [TikTok posting API for AI agents](https://chirpie.ai/docs/platforms/tiktok.md): How Chirpie lets an AI agent publish TikTok photo posts from one API call or an MCP tool, with a caption, up to 35 images and scheduling.
- [X API for AI agents](https://chirpie.ai/docs/platforms/x.md): Let an AI agent post, thread, schedule and track posts on X (Twitter) through one Chirpie API key or MCP tool, with no X developer account.
- [YouTube upload API for AI agents](https://chirpie.ai/docs/platforms/youtube.md): How Chirpie lets an AI agent upload a YouTube video or Short from one API call or an MCP tool, with a title, a description and scheduling.
- [TypeScript SDK](https://chirpie.ai/docs/sdk.md): Use the @chirpie/sdk package for type-safe API access from Node.js and TypeScript.
- [Skills](https://chirpie.ai/docs/skills.md): Install Chirpie skills so Claude Code and other AI coding agents know how to use Chirpie automatically.

## Pages
- [Chirpie for OpenClaw](https://chirpie.ai/openclaw): Give an OpenClaw agent a social media account. Install the skill or connect the MCP server.
- [Support](https://chirpie.ai/support): How to get help with Chirpie, and where to manage accounts, API keys and billing.

## Comparisons
- [Social media APIs for AI agents, compared (2026)](https://chirpie.ai/compare): Sourced, dated comparison of Ayrshare, Blotato, Buffer, Post Bridge, Postiz, Zernio, and Chirpie.
- [Chirpie vs Ayrshare](https://chirpie.ai/alternatives/ayrshare): Ayrshare prices per client profile from $149 a month and covers 14 networks, with comments, DMs and ad boosts. Chirpie starts free. Sourced, checked September 2026.
- [Chirpie vs Postiz](https://chirpie.ai/alternatives/postiz): Postiz is open source (AGPL-3.0) with 34 platforms and a calendar; Chirpie is a hosted posting API with a free plan. Pricing at 1, 3 and 10 accounts, sourced.
- [Chirpie vs Zernio](https://chirpie.ai/alternatives/zernio): Zernio, formerly Late, charges per connected account with two free and adds DMs, reviews and seven ad networks. Chirpie charges per post. Sourced comparison.
- [Chirpie vs Post Bridge](https://chirpie.ai/alternatives/post-bridge): Post Bridge is $39 a month for 15 accounts with unlimited posts on 10 platforms; Chirpie adds threads and X links and starts free. Checked September 2026.
- [Chirpie vs Blotato](https://chirpie.ai/alternatives/blotato): Blotato bundles publishing to 9 platforms with AI writing, images, video and voiceovers from $29 a month; Chirpie publishes what you bring, from free. Sourced.
- [Chirpie vs Buffer](https://chirpie.ai/alternatives/buffer): Buffer charges per channel with a free plan, a calendar, a community inbox and a GraphQL API with MCP. Chirpie is REST with a TypeScript SDK. Sourced comparison.
- [Chirpie vs X API](https://chirpie.ai/alternatives/twitter-api): Calling the X (Twitter) API directly costs $0.015 per post and $0.200 per post with a URL, pay-per-use. What you build yourself, and what Chirpie handles. Sourced.

## Tools
- [X API pricing calculator](https://chirpie.ai/tools/x-api-pricing-calculator): Estimate a monthly X API bill under X's pay-per-use rates.

## For agents
- [auth.md](https://chirpie.ai/auth.md): How an agent gets and uses a Chirpie credential: OAuth through the MCP server, or an API key.
- [MCP server card](https://chirpie.ai/.well-known/mcp/server-card.json): The hosted MCP server's endpoint, authentication and tools.
- [API catalog](https://chirpie.ai/.well-known/api-catalog): The REST API and the MCP server, with their docs and status (RFC 9727).
- [Agent skills](https://chirpie.ai/.well-known/agent-skills/index.json): The Chirpie agent skills, each with its SKILL.md.