# iGloo — full agent reference

> Everything an agent needs to drive iGloo over MCP, in one file: connection, the 17 tools, outbound webhooks, copy-paste prompt recipes, and behavioural notes. The scannable index is at https://igloo-hq.fly.dev/llms.txt.

## Connection

- Endpoint: https://igloo-hq.fly.dev/api/mcp (streamable HTTP, POST JSON-RPC; send Accept: application/json, text/event-stream)
- Auth: Authorization: Bearer <igloo_ key> — mint one at https://igloo-hq.fly.dev/account/developer (shown once, hashed at rest)
- A key acts as its owner and can only touch communities that user owns or admins
- tools/list enumerates everything; tools/call runs one; the machine manifest is a GET on the endpoint (no auth)

## Tools (17)

Every tool takes community_slug except list_communities and create_community. Write tools are owner/admin-only and fail with a message that says exactly what to fix.

- list_communities — communities this key can act on, with role + slug
- create_community — deploy a new community; the key's owner owns it
- community_stats — member / post / course / event counts
- invite_member — register a person by email (account auto-created, unique handle)
- create_post — publish a post; broadcast=true notifies every member
- create_event — schedule an event (Zoom/Meet/custom link, optional weekly repeat)
- create_course / create_module / create_lesson — build the whole course tree by typing
- set_course_drip — release schedule: none / days after enrolment / fixed date
- publish_course — publish or unpublish; get_course — read the tree back
- list_level_rewards / set_level_reward — the Expedition ladder (text | course | webhook | chat)
- get_onboarding / configure_onboarding — up to 5 joining questions + the member.joined webhook
- set_labels — rename tabs + the 5 Expedition level names

## Webhooks out

member.joined and reward.unlocked POST to your systems, HMAC-signed (x-igloo-signature: sha256=<HMAC-SHA256 of body>). Configure the member webhook via configure_onboarding.

## Payments

Deliberately not in MCP. Sell access by creating a GoCushy product for the community or course; iGloo grants and revokes entitlements from GoCushy's signed webhooks.

## Prompt recipes

Start any session with "List my iGloo communities" so the agent knows the slugs before acting.

### Launch a community from scratch

    Create an iGloo community called "Founder Fastlane" for indie SaaS founders.
    Then:
    - Post a pinned welcome that explains it's a place to share launches and get
      feedback, and to introduce yourself.
    - Add a weekly "Launch Review" event every Thursday at 9am NZT on Zoom
      (link: https://zoom.us/j/123).
    - Invite alex@example.com and sam@example.com.
    Give me the community link when you're done.

### Build a course by typing

    In "founder-fastlane", create a course called "Cold Start Playbook":
    - Module 1 "Find the itch": lessons "Pick a painful problem" and "Talk to 10
      people" (plain-text bodies, ~5 min each).
    - Module 2 "Ship the wedge": lessons "Scope the 2-week version" and "Launch
      to 20 people", with this video on the last one:
      https://www.youtube.com/watch?v=XXXX
    Drip it at 7 days per module after enrolment, publish it, then read the
    course back to me so I can check the structure.

### Set up member capture (autoresponder)

    For my "founder-fastlane" community, configure onboarding:
    - Ask three joining questions: "What are you building?", "What stage are you
      at?", and "What's your #1 goal this quarter?"
    - Send new members to my Zapier hook: https://hooks.zapier.com/hooks/catch/abc123
    Then show me the current onboarding config so I can confirm.

### Design the reward ladder

    Show me the Expedition reward ladder for "founder-fastlane". Then set:
    - Level 2 (Explorer): give course access to the "getting-started" course.
    - Level 3 (Pathfinder): a chat message from me — "Here's your 20% code: FAST20".
    - Level 4 (Guide): a webhook reward labelled "Founder swag pack" that posts to
      https://hooks.zapier.com/hooks/catch/def456
    Confirm what each level now unlocks.

### Weekly operating rhythm

    Every Monday I'll ask you to run our weekly update. When I do:
    1. Pull community_stats for "founder-fastlane".
    2. Draft a broadcast post celebrating the numbers and this week's focus, and
       publish it as a broadcast so everyone gets notified.
    3. Schedule this Thursday's Launch Review event if it isn't already there.

### Onboard a cohort

    I'm pasting a list of names + emails. For "founder-fastlane", invite each one,
    then publish (not broadcast) a single welcome post that @-introduces the new
    cohort by first name.

    <paste your list>

### Turn a course into a community perk

    In "founder-fastlane", create a course called "Cold Start Playbook". Then make
    reaching Level 2 unlock free access to it, and post an announcement that members
    who stay active unlock the Playbook for free.

### Health check / audit

    Audit "founder-fastlane" for me:
    - community_stats
    - current onboarding config (questions + capture webhook)
    - the full reward ladder
    Then suggest 3 concrete improvements to activation and retention.

## How the agent behaves

- Errors teach it: a bad course_slug returns the valid slugs; a non-https webhook URL is rejected with the reason. Retry with the correction.
- Broadcasts notify every member; plain posts only appear in the feed. Say "broadcast" deliberately.
- create_post bodies are plain text (blank lines = paragraphs); a bare media URL on its own line auto-embeds (YouTube/Vimeo/Wistia/Loom, images, audio, mp4).
- If a community requires approval, invite_member skips the queue; self-serve joiners land in the pending queue with their answers.
- Human docs and the same recipes with copy buttons: https://igloo-hq.fly.dev/developers