MCP server

The IP Bot MCP server (@island-pitch/ip-bot-mcp) runs over stdio and exposes the content pipeline as tools, plus resources that teach agents the Powers catalog and Winds economy.

Configure

Add this to your MCP client config (Cursor's mcp.json, Claude Desktop, etc.):

{
  "mcpServers": {
    "ip-bot": {
      "command": "npx",
      "args": ["-y", "@island-pitch/ip-bot-mcp"],
      "env": {
        "IPBOT_APPSYNC_ENDPOINT": "https://api.islandpitch.bot/graphql",
        "IPBOT_API_KEY": "ipbot_live_xxxxxxxxxxxxxxxx"
      }
    }
  }
}

Claude Code one-liner and per-tool instructions are on Set up your AI tool.

Tools

• Powers & Winds — list_powers, run_power, get_winds_balance, topup_winds.
• Content pipeline — create, submit, approve, reject, schedule, publish, cancel, list/get drafts, calendar, accounts — plus upload_media for native image hosting and reschedule_schedule to move a publication.
• AutoReply campaigns — create_campaign, list_campaigns, get_campaign, update_campaign, set_campaign_status, set_campaign_steps, set_campaign_triggers — Instagram comment/DM automation with keyword + media-ID trigger scoping (triggerMediaIds; empty = all media). Meta rules enforced: one private reply per comment (ever), 7-day private-reply window, 24h free-form DM window.
• Organizations — create orgs, invite/remove members, roles, share accounts.
• Tokenized review — create shareable review links, list/revoke, add/list comments.
• Analytics — cached post insights.

Drafts are accessible by default: altText is a first-class create_content_draft param whose description steers agents to always provide it, and mediaAltTexts covers carousels — per-child alt text paired by index with mediaUrls(images only; Instagram crops all carousel children to the first child's aspect ratio). The Meta features most tools skip ship as plain params — venue locationId, collaborators co-author invites for the featured accounts, story, callToAction, and 21+ targeting for compliance content. Failures come back as typed {error: {code, message}}, and externalRef makes creates idempotent — retries never double-post.

Resources (what the agent can read)

• ipbot://powers/catalog — every Power, its cost, and how to run it.
• ipbot://winds/economy — how Winds are spent & acquired.
• ipbot://guide/agent-workflows — the recommended agent playbook.

Configuration

• IPBOT_APPSYNC_ENDPOINT — your AppSync GraphQL endpoint.
• IPBOT_API_KEY — your agent API key (ipbot_live_…).
• IPBOT_AUTH_TOKEN — optional Cognito JWT instead of an API key.

Pair it with the Powers skill so your agent knows which tool to reach for and how Winds are billed.