# iGloo

> iGloo is a community platform (courses, events, chat, gamified progression) that AI agents can run end-to-end over MCP. Deploy a community, register members, publish posts, schedule events, build courses, wire reward ladders and member-capture webhooks — all from natural language. Payments stay in GoCushy.

## Connect over MCP

- Endpoint: https://0.0.0.0:3000/api/mcp
- Transport: streamable HTTP (POST)
- Auth: Authorization: Bearer <igloo_ key>  — mint one at https://0.0.0.0:3000/account (shown once)
- A key acts as its owner and can only touch communities that user owns or admins.
- Machine manifest (no auth): https://0.0.0.0:3000/api/mcp  (GET)

Claude Desktop / Claude Code config:
{
  "mcpServers": {
    "igloo": {
      "url": "https://0.0.0.0:3000/api/mcp",
      "headers": { "Authorization": "Bearer igloo_YOUR_KEY" }
    }
  }
}

Any other client: JSON-RPC over HTTP with the Bearer header and
Accept: application/json, text/event-stream. tools/list enumerates; tools/call runs one.

## Mental model

- A community is the unit; addressed by URL slug (e.g. "founder-fastlane"). Call list_communities FIRST to learn the user's slugs — almost every tool takes community_slug.
- Expedition = a 5-level gamified progression. Attach a reward to a level with set_level_reward: text (a promise), course (auto-enrol), chat (owner DMs the member), or webhook (signed POST). Rewards fire automatically on level-up.
- Onboarding = up to 5 joining questions + a member.joined webhook that captures every new member into a CRM/autoresponder.
- Payments are NOT in MCP: sell access by creating a GoCushy product for the community/course; iGloo grants entitlements from GoCushy's webhook.

## Tools (12)

- 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 a course shell (add lessons in the web UI)
- list_level_rewards — read the Expedition reward ladder + usable course slugs
- set_level_reward — set a level's reward (text | course | webhook | chat)
- get_onboarding — read joining questions + the member-capture webhook
- configure_onboarding — set ≤5 joining questions + the member.joined webhook
- set_labels — rename tabs + the 5 Expedition level names

Write tools are owner/admin-only and fail with a message that tells you exactly what to fix (e.g. a bad course_slug returns the list of valid slugs).

## Webhooks out (non-MCP integration)

Two events flow OUT of iGloo to your systems, HMAC-signed (x-igloo-signature: sha256=<HMAC-SHA256 of body>):
- member.joined — {event, member:{email,name,handle}, answers:{...}} — autoresponder/CRM capture
- reward.unlocked — fired when a member reaches a level with a webhook reward

## Recipes

Copy-paste prompts that drive the tools (launch a community, member capture, reward ladder, weekly rhythm, cohort onboarding, audit):
- https://0.0.0.0:3000/developers

## Notes

- Keys are hashed at rest (SHA-256); the plaintext is never stored.
- create_post bodies are plain text (blank lines = paragraphs); a bare media/video URL on its own line auto-embeds (YouTube/Vimeo/Wistia/Loom, images, audio, mp4).
- The embeddable read-only community widget lives at https://0.0.0.0:3000/embed/<community-slug>.