MCP Server

Let Claude and other AI agents post to X, Bluesky, LinkedIn, Threads, Mastodon, Instagram, Facebook, Telegram, Reddit, Pinterest, TikTok, YouTube, Google Business Profile, and Snapchat through the Chirpie MCP server.

The Chirpie MCP (Model Context Protocol) server exposes Chirpie tools to AI agents like Claude. All tools work with X, Bluesky, LinkedIn, Threads, Mastodon, Instagram, Facebook, Telegram, Reddit, Pinterest, TikTok, YouTube, Google Business Profile, and Snapchat accounts.

Setup

1. Authenticate

Install the CLI and log in (opens browser — if you're already signed in, it's instant):

npm install -g chirpie
chirpie login

The MCP server reads saved credentials from ~/.chirpie/config.json automatically. No API key needed in your MCP config.

Alternatively, set CHIRPIE_API_KEY as an environment variable (useful for CI/CD or Docker).

2. Configure Your AI Client

claude mcp add chirpie -- npx @chirpie/mcp

Or add to your project's .mcp.json:

{
  "mcpServers": {
    "chirpie": {
      "type": "stdio",
      "command": "npx",
      "args": ["@chirpie/mcp"]
    }
  }
}

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "chirpie": {
      "command": "npx",
      "args": ["@chirpie/mcp"]
    }
  }
}

Add to your Cursor MCP settings:

{
  "mcpServers": {
    "chirpie": {
      "command": "npx",
      "args": ["@chirpie/mcp"]
    }
  }
}

Available Tools

Tool	Description
`chirpie_post`	Create a single post
`chirpie_thread`	Create a thread (2-25 posts)
`chirpie_list_posts`	List posts with optional filters
`chirpie_get_post`	Get a single post by ID
`chirpie_delete_post`	Delete a post
`chirpie_list_accounts`	List connected accounts (all 14 platforms)
`chirpie_analytics`	Get engagement metrics for a post

Tool Details

chirpie_post

Parameter	Type	Required	Description
`account_id`	`string`	Yes	Account UUID (any of 14 platforms)
`text`	`string`	Yes	Post text. Max: 280 (X), 25,000 (X Premium), 300 (Bluesky), 3,000 (LinkedIn), 500 (Threads), 500 (Mastodon), 2,200 (Instagram), 63,206 (Facebook), 4,096 (Telegram), 40,000 (Reddit), 500 (Pinterest), 2,200 (TikTok), 5,000 (YouTube), 1,500 (Google Business Profile), 160 (Snapchat)
`media_urls`	`string[]`	No	Public image/video URLs. Limits vary by platform. Instagram, Pinterest, TikTok, YouTube, and Snapchat REQUIRE media.
`schedule_at`	`string`	No	ISO 8601 datetime

chirpie_thread

Parameter	Type	Required	Description
`account_id`	`string`	Yes	Account UUID (any of 14 platforms)
`posts`	`array`	Yes	Array of `{ text, media_urls? }` objects (2-25). Media limits vary by platform. LinkedIn, Instagram, Facebook, Pinterest, TikTok, YouTube, Google Business Profile, and Snapchat post each item standalone (no native threading). Reddit threads via comments.
`schedule_at`	`string`	No	ISO 8601 datetime

chirpie_list_posts

Parameter	Type	Required	Description
`status`	`string`	No	Filter by status
`account_id`	`string`	No	Filter by account
`limit`	`number`	No	Results to return

chirpie_list_accounts

No parameters required. Returns all connected accounts (all 14 platforms).

chirpie_analytics

Parameter	Type	Required	Description
`post_id`	`string`	Yes	Post UUID

Example Prompts

Once configured, you can ask Claude:

"Post a tweet saying 'Just shipped a new feature!'"
"Post to Bluesky saying 'Hello from Chirpie!'"
"Post to LinkedIn about our new product launch"
"Post to Threads saying 'Check out what we built!'"
"Post to Mastodon saying 'Hello from Chirpie!'"
"Post to Instagram with this image" (requires media)
"Post to our Facebook Page about the product launch"
"Send a message to our Telegram channel"
"Create a thread about the benefits of TypeScript"
"Show me my recent posts"
"What are the analytics for my last post?"
"Schedule a post for tomorrow at 9am saying 'Good morning!'"
"List my connected accounts"

Authentication Flow

The MCP server resolves your API key in this order:

CHIRPIE_API_KEY environment variable (if set — useful for CI/CD)
~/.chirpie/config.json (written by chirpie login)

Both the CLI and MCP server share the same config file. One chirpie login authenticates both — no API key in your MCP config needed.

On this page