MCP Server

The Chirpie MCP (Model Context Protocol) server exposes Chirpie tools to AI agents like Claude.

Setup

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).

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"]
    }
  }
}

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 X accounts
`chirpie_analytics`	Get engagement metrics for a post

Parameter	Type	Required	Description
`account_id`	`string`	Yes	X account UUID
`text`	`string`	Yes	Post text (max 280 chars)
`media_urls`	`string[]`	No	Up to 4 public image/video URLs (JPEG, PNG, WebP, GIF up to 5MB; MP4/MOV up to 512MB)
`schedule_at`	`string`	No	ISO 8601 datetime

Parameter	Type	Required	Description
`account_id`	`string`	Yes	X account UUID
`posts`	`array`	Yes	Array of `{ text, media_urls? }` objects (2-25)
`schedule_at`	`string`	No	ISO 8601 datetime

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

No parameters required. Returns all connected X accounts.

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

Once configured, you can ask Claude:

The MCP server resolves your API key in this order:

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