Docs navigation

Quickstart

From zero to your first automation.

1. Get access

IP Bot is in private beta. Request beta access — once approved you'll get a login, a starter license, and 40 free Winds a week. Grab your API endpoint and key from Settings → API Keys.

2. Pick how you'll drive it

In the app — connect an account and run a Power from the dashboard.
CLI — for scripts, CI, and quick automation.
MCP / agent — let Claude Code, Cursor, or any MCP client run Powers for you.

3. Connect the CLI

bash

> export IPBOT_APPSYNC_ENDPOINT=https://api.islandpitch.bot/graphql
> export IPBOT_API_KEY=ipbot_live_xxxxxxxxxxxxxxxx
> npx @island-pitch/ip-bot-cli auth whoami --output json

4. Wire up an agent

Add the MCP server and install the Powers skill so your agent understands the catalog and the Winds economy:

bash

> claude mcp add ip-bot \
>   -e IPBOT_APPSYNC_ENDPOINT=https://api.islandpitch.bot/graphql \
>   -e IPBOT_API_KEY=ipbot_live_xxxxxxxxxxxxxxxx \
>   -- npx -y @island-pitch/ip-bot-mcp
> 
> npx @island-pitch/ip-bot-skills

Full per-tool setup is on Set up your AI tool.

5. Run your first Power

List the catalog, then run a Power. power-qr-code-generator is free (0 Winds) and needs no connectors — the perfect first call:

bash

> # List the catalog (machine-readable)
> npx @island-pitch/ip-bot-cli powers list --output json
> 
> # Run the free QR Power
> npx @island-pitch/ip-bot-cli powers run power-qr-code-generator \
>   --input '{"data":"https://islandpitch.bot"}' --output json

A successful run returns the result plus the Winds spent (refunded automatically if a run fails):

json

{
  "success": true,
  "powerId": "power-qr-code-generator",
  "windsSpent": 0,
  "result": { "qrCodeUrl": "https://.../qr/abc123.png" }
}

That's your first Power. Next: check your balance with npx @island-pitch/ip-bot-cli winds balance --output json, connect a real account (ipbot accounts list), or browse the full Powers catalog and Winds economy. Every command supports --output json; on failure it returns a typed error code (INSUFFICIENT_WINDS, UNAUTHENTICATED, …).