AI agent
Agents CLI + CatCaster
HTTP and client CLIs—no CatCaster binary
Headless automation uses the same MCP URL. Prefer OAuth in interactive clients; use API keys only where browser login is impossible.
Example chat
via CatCaster MCP · Agents CLI
How to connect Agents CLI
- Claude Code: claude mcp add with SSE transport to the CatCaster URL.
- Codex / custom scripts: JSON-RPC POST to /api/mcp with Bearer API key.
- Claude Desktop (legacy): optional local scripts/mcp-server.mjs bridge with SOCIAL_API_KEY.
- Never commit API keys; rotate keys in Settings → Developer if leaked.
CatCaster MCP server URL
https://www.catcaster.com/api/mcp
cURL tools/list (API key)
curl -X POST https://www.catcaster.com/api/mcp \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'
OAuth sign-in is recommended. Developer API keys in Settings → Developer work for clients that cannot open the browser consent flow. Keep a human in the loop before publish_post and send_inbox_reply.
What you can do with Agents CLI
Claude Code
Interactive terminal sessions with OAuth when available.
curl / HTTP
tools/list and tool calls for debugging integrations.
Local bridge
scripts/mcp-server.mjs for stdio clients that cannot speak remote OAuth directly.
No catcaster-cli
We do not ship a standalone npm binary named catcaster—clients speak MCP directly.
Channels agents can reach
Example prompts
- Document the difference between remote MCP OAuth and the Desktop stdio bridge.
- List environment variables for scripts/mcp-server.mjs.
Agents should run validate_post and show drafts before scheduling or publishing. CatCaster MCP does not generate images or video—attach media the agent already has via upload_media or HTTPS URLs on create_post.
Frequently asked questions
- Is CatCaster preinstalled in ChatGPT or Claude?
- No. You add CatCaster as a custom MCP connector (or use OAuth from a client that supports remote MCP). Sign in with your CatCaster account when the client opens the consent flow.
- Will the agent publish without asking me?
- CatCaster expects a human in the loop. Agents should run validate_post and show drafts before schedule_post or publish_post. Inbox send_inbox_reply should only run after you explicitly approve the draft.
- Can agents generate images or video inside MCP?
- Not through CatCaster MCP today. Agents can attach media they already have via upload_media (HTTPS URL) or URLs on create_post. Image and video generation in the product UI is separate from MCP.
- What platforms can agents reach?
- Any channel already connected in your workspace—Instagram, Facebook, Threads, TikTok, LinkedIn, X, YouTube, Pinterest, and your CatCaster blog, subject to each platform’s API limits documented on our platform guides.
- Is there a CatCaster CLI npm package?
- No. Use MCP-compatible clients (Claude Code, Cursor, curl) or the optional scripts/mcp-server.mjs helper for Claude Desktop-style stdio setups.