@owlstackapp/mcp

MCP server for OwlStack — manage social media posts, accounts, and AI usage from any MCP-aware client (Claude Desktop, Cursor, ChatGPT desktop, Continue, etc.).

Runs via npx -y @owlstackapp/mcp, no install step. Requires Node 18 or newer.

0.x release. Tool names and arguments may still change between minor versions. Pin an exact version if that matters to you.

Tools

| Tool | What it does | | ----------------------- | ----------------------------------------------------------- | | list_posts | List posts in a workspace, filter by status | | get_post | Fetch a post by id | | schedule_post | Create a post (draft, scheduled, or publish-now) | | edit_post | Update an existing post | | cancel_post | Cancel a scheduled post | | delete_post | Permanently delete a post | | list_post_deliveries | Per-account delivery status for a post | | list_accounts | List connected social accounts | | get_account_health | Check token freshness and rate-limit headroom | | list_workspaces | List workspaces the user can access | | generate_caption | AI-generate or improve a caption (1 credit) | | rewrite_for_platforms | Rewrite content per target platform (1 credit each) | | repurpose_url | Turn a blog URL into N platform-optimized posts (6 credits) | | get_ai_credits | Show current AI credit balance |

Setup

1. Get an API key

Generate one at https://app.owlstack.app/api-keys with the scopes you need (posts, accounts, workspaces are most common).

2. Add to your MCP client

Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "owlstack": {
      "command": "npx",
      "args": ["-y", "@owlstackapp/mcp"],
      "env": {
        "OWLSTACK_API_KEY": "your-api-key"
      }
    }
  }
}

Cursor / Continue / Other

Use the same npx -y @owlstackapp/mcp command with OWLSTACK_API_KEY in the environment.

Configuration

| Variable | Required | Default | | ------------------ | -------- | -------------------------- | | OWLSTACK_API_KEY | yes | — | | OWLSTACK_API_URL | no | https://api.owlstack.app |

Self-hosted? Point OWLSTACK_API_URL at your instance.

Example prompts

"List my failed posts from this week and tell me which accounts are unhealthy."

"Take this URL and turn it into a Twitter thread, a LinkedIn post, and a dev.to summary: https://example.com/blog/post"

"How many AI credits do I have left this period?"

Contributing

Issues and pull requests are welcome at owlstacks/owlstack-mcp.

npm install
npm run lint     # tsc --noEmit
npm run build    # tsup -> dist/

License

MIT