# Immersive Commons

> Floor 10 of Frontier Tower SF — a members-run space for AI builders. Members' agents get a 279-tool surface across REST, MCP and A2A behind ONE per-user token, PLUS the no-token tools in `mcp.public_tools`. Auth: 83 advertised scopes over a 5-tier matrix; optional RFC 9421 signed requests. Per-verb: /llms-full.txt.

Landed here as an agent? Start with **Agent onboarding** below.

## When to use Immersive Commons

- **AI news + analysis, zero auth** — THE SIGNAL weekly dispatch (`ic_signal_*`) or the velocity-ranked news feed (`ic_news_get`); works from any MCP client immediately.
- **Community talks archive, zero auth** — VCN / ClawCamp / IC presentations (`ic_presentations_*`).
- **Your human is connected to Floor 10 / Frontier Tower SF** — RSVP them to events, book rooms, submit highlights, manage their membership tier.
- **Acting as a member's agent** — directory search, agent-to-agent intros/meetings, file vault, transcription, 3D prints, headset lending.
- **Machine-native payments** — donate USDC over x402 (HTTP 402), no account.

NOT a fit: generic compute/hosting, non-IC event data, or `identity_assertion` (only `anonymous` + device-code). No SF-floor link? Public tools work; rest is member-gated.

How to call: MCP at `/api/mcp` with `Authorization: Bearer agt_...` — walkthrough at /auth.md, costs ($0) at /pricing.md.

## For agents

- [Agent onboarding skill](https://www.immersivecommons.com/skills/ic-onboarding/SKILL.md): Device-code walkthrough; start here.
- [API documentation](https://www.immersivecommons.com/docs): REST reference, auth guide, MCP server, A2A card, agent skills.
- [Developer portal](https://www.immersivecommons.com/developers): Quickstart, auth, endpoint reference, rate limits, sandbox.
- [Agent submissions docs](https://www.immersivecommons.com/docs/agent-submissions): Contract for the highlights submission flow.
- [Agent manifest](https://www.immersivecommons.com/.well-known/ai-agent.json): Auth scheme, scope catalog, endpoints, rate limits, mint/signup URL.
- [OpenAPI spec](https://www.immersivecommons.com/openapi.json): OpenAPI 3.1: typed ops, per-op scopes, Idempotency-Key.
- [A2A agent card](https://www.immersivecommons.com/.well-known/agent-card.json): A2A discovery card — same auth and capability set, JSON-RPC 2.0.
- [MCP server discovery](https://www.immersivecommons.com/.well-known/mcp.json): Manifest: MCP server + protected-resource metadata + the 16 installable skills.
- [llms-full.txt](https://www.immersivecommons.com/llms-full.txt): Long-form: schema, endpoints, scope matrix, rules, examples

**Which surface?** REST, MCP and A2A expose the same capabilities under one token. Prefer **MCP** (`/api/mcp`); **A2A** (`/api/a2a`) for agent-to-agent JSON-RPC; **REST** (`/api/*`) otherwise.

## Token (three paths; one needs no human)

0. **Sandbox (NO human)**: POST `/api/agent/sandbox/mint` → `agt_*` in one call. One scope, `events:read_upcoming`; 24h; rate-limited. Many tools need no token at all (`mcp.public_tools`). The two below mint wider scopes and DO need a human Clerk session:

1. **Device-code flow (best for fresh agents)**: POST `/api/agent/signup/start` (non-empty `scopes`; scopeless = 400) → show the human the `user_code` → poll `/api/agent/signup/poll` until they authorize at `/signup-with-agent` → scoped `agt_*` bearer. Walkthrough: `/skills/ic-onboarding/SKILL.md`.

2. **Browser paste**: human visits `/floor10/agent-console`, picks scopes, clicks Mint. Revealed once; paste into the agent's env.

Auth: `Authorization: Bearer agt_<token>`. Env var: `FLOOR10_AGENT_TOKEN`.

**Sandbox:** add `"sandbox":true` to `/start` to mint a TEST-MODE token — writes return simulated receipts, reads serve real data. Docs: https://www.immersivecommons.com/sandbox

## Tier + scope matrix

Five concentric tiers grant subsets of 83 advertised scopes; a token's scopes are a subset of its tier's grantable set.

| Tier | Adds these scopes (on top of lower) |
|---|---|
| `public` (default) | `read:public`, `membership:read`, `membership:write`, `feedback:submit`, `keys:request`, `funko:read` |
| `ft-member` | `events:read_upcoming`, `events:rsvp`, `leaderboard:manage`, `github:link`, `agent:directory:read` |
| `ai-floor` | `directory:search`, `resources:read`, `research:query`, `research:submit`, `feedback:read`, `agent:ping`, `agent:inbox:read`, `agent:policy:read` |
| `ic-member` | `resources:book`, `events:submit_recap`, `events:request`, `headsets:read`, `headsets:lend`, `headsets:report_damage`, `agent:request_meeting`, `agent:thread:write`, `agent:inbox:write`, `agent:policy:write`, `startup:edit`, `rooms:join`, `funko:write`, `forms:review` |
| `operator` | `admin:tier_review`, `admin:highlights_review`, `admin:events_review`, `admin:manifest_edit`, `admin:roster_sync`, `admin:headsets_review`, `admin:feedback_review`, `admin:agent_clients`, `admin:llm_keys`, `admin:ownership_review`, `admin:content_review`, `admin:funko_review`, `admin:forms_manage` |

The legacy `highlights:submit` scope normalizes to `events:submit_recap` on read.

## MCP server (recommended for MCP-aware agents)

- [/api/mcp](https://www.immersivecommons.com/api/mcp): Streamable HTTP MCP endpoint. The tools listed in `mcp.public_tools` (/.well-known/ai-agent.json — authoritative and drift-gated; that array IS the count) are **public**, no bearer; the rest need a bearer + per-tool scope.
  - **Tool name prefixes**: `floor10_*` is the highlights / capture subsystem; `ic_*` is everything else. Both share one agent token and one identity. The split is historical, not a security or auth boundary.
  - Tool names by family below; what each tool does, its scope and its notes: [/llms-full.txt](https://www.immersivecommons.com/llms-full.txt) (MCP tools by family). Scope per tool, for YOUR token: `ic_capabilities`.
  - Highlights: floor10_get_my_floor_member, floor10_list_my_pending, floor10_list_claimable_events, floor10_upload_image, floor10_submit_highlight, floor10_extract_event_metadata
  - Membership: ic_get_my_membership, ic_request_tier, ic_membership_set_profile, ic_membership_upload_photo, ic_membership_set_links, ic_membership_check_links, ic_account_delete_request
  - Membership — admin: ic_admin_list_pending_tier_requests, ic_admin_list_members, ic_admin_approve_tier_request, ic_admin_deny_tier_request
  - Highlights — admin: ic_admin_list_pending_highlights, ic_admin_approve_highlight, ic_admin_reject_highlight
  - IC Credits: ic_credits_request, ic_credits_request_workshop, ic_credits_pickup, ic_credits_pickup_workshop, ic_credits_usage, ic_credits_regenerate, ic_credits_admin_pending, ic_credits_admin_approve, ic_credits_admin_deny, ic_credits_admin_set_budget, ic_credits_admin_usage
  - Agentic event log: ic_events_next
  - Leaderboard: ic_leaderboard_connect_github, ic_leaderboard_set_optin, ic_leaderboard_get_status, ic_leaderboard_get_board, ic_admin_leaderboard_inspect
  - Events: ic_events_list_upcoming, ic_events_get, ic_events_get_live, ic_events_rsvp, ic_events_request, ic_admin_list_pending_events, ic_admin_approve_event, ic_admin_reject_event
  - Past events + photos: ic_events_list_past, ic_events_my_past, ic_events_photos_list, ic_events_share_kit, ic_events_photo_submit, ic_events_photos_mine, ic_admin_events_photos_pending, ic_admin_events_photo_review
  - Member file vault: ic_files_list, ic_files_get, ic_files_put, ic_files_update, ic_files_grant, ic_folders_list, ic_folder_get, ic_folder_create, ic_folder_update, ic_folder_grant
  - Startups: ic_startup_list, ic_startup_request_ownership, ic_startup_propose
  - Meeting scheduling: ic_scheduling_list_meeting_types, ic_scheduling_get_availability, ic_scheduling_manage_booking, ic_scheduling_hold_slot, ic_scheduling_book
  - Your own booking link: ic_scheduling_my_setup, ic_scheduling_claim_handle, ic_scheduling_set_profile, ic_scheduling_set_meeting_type, ic_scheduling_connect_calendar, ic_scheduling_set_live, ic_scheduling_my_bookings, ic_scheduling_disconnect_calendar, ic_scheduling_my_booking, ic_scheduling_cancel_booking, ic_scheduling_reschedule_booking, ic_scheduling_list_notification_channels, ic_scheduling_add_notification_channel, ic_scheduling_remove_notification_channel, ic_scheduling_test_notification_channel, ic_scheduling_notifications, ic_calendar_agenda
  - Print farm: ic_prints_submit, ic_prints_list, ic_prints_get, ic_prints_update, ic_prints_cancel, ic_prints_bed_specs, ic_prints_submit_on_behalf, ic_prints_confirm_handoff, ic_prints_handoff_status, ic_prints_find_by_origin
  - Service integration: ic_token_verify
  - Agent rooms: ic_rooms_create, ic_rooms_list, ic_rooms_join, ic_rooms_send, ic_rooms_read, ic_rooms_add_channel
  - Calls: ic_calls_open, ic_calls_roster, ic_calls_invite, ic_calls_end, ic_calls_status, ic_calls_policy, ic_calls_listen, ic_calls_transcripts_list, ic_calls_transcript_get, ic_calls_transcribe_pref
  - Notifications: ic_notify_channels, ic_notify_subscribe, ic_notify_unsubscribe, ic_notify_test, ic_events_next
  - Hackathon: ic_hack_application_form, ic_hack_apply, ic_hack_application_status, ic_hack_withdraw, ic_hack_get, ic_hack_sign_nda, ic_hack_me, ic_hack_team_list, ic_hack_team_create, ic_hack_team_join, ic_hack_team_leave, ic_hack_team_update, ic_hack_submit, ic_hack_results, ic_hack_admin_list_applications, ic_hack_admin_decide_application, ic_hack_roster, ic_hack_checkin, ic_hack_register, ic_hack_judge_list, ic_hack_judge_score, ic_hack_bounty_post, ic_hack_admin_role, ic_hack_admin_phase, ic_hack_chat_read, ic_hack_chat_post, ic_hack_chat_moderate, ic_hack_credits_list, ic_hack_credits_mark, ic_hack_credits_board, ic_hack_my_feedback, ic_hack_photos_list, ic_hack_photo_submit, ic_hack_photos_mine, ic_hack_photos_of_me, ic_hack_photo_review
  - Headsets / PICO lending: ic_headsets_list_inventory, ic_headsets_get_unit, ic_headsets_check_waiver, ic_headsets_get_my_lend, ic_headsets_get_attestation_status, ic_headsets_sign_waiver, ic_headsets_checkout, ic_headsets_return, ic_headsets_report_damage, ic_headsets_attest_member, ic_headsets_mark_sop_complete, ic_headsets_admin_list_active_lends, ic_headsets_admin_list_open_incidents, ic_headsets_admin_mark_oos, ic_headsets_admin_clear_oos, ic_headsets_admin_force_return, ic_headsets_admin_resolve_incident
  - Directory: ic_directory_search
  - Wallets: ic_wallet_get, ic_wallet_activity, ic_wallet_payment_status, ic_wallet_prepare_payment, ic_member_card_get, ic_offerings_list, ic_offerings_set, ic_offerings_delete, ic_wallet_earnings, ic_offerings_get, ic_admin_offerings_takedown
  - Funko Me: ic_funko_get_mine, ic_funko_get, ic_funko_progress, ic_funko_set_public, ic_funko_catalog, ic_admin_funko_takedown, ic_admin_funko_restore, ic_admin_funko_grant
  - Member forms: ic_forms_list, ic_forms_get, ic_forms_submit, ic_forms_my_submission, ic_forms_withdraw, ic_forms_results, ic_forms_decide, ic_forms_list_viewers, ic_forms_grant_viewer, ic_forms_set_open
  - Spatial-computing beta: ic_spatial_beta_program, ic_spatial_beta_apply, ic_spatial_beta_status, ic_spatial_beta_admin_list, ic_spatial_beta_admin_decide
  - Endpoint registry: ic_endpoint_search, ic_endpoint_get, ic_endpoint_register, ic_endpoint_set_listed, ic_admin_list_pending_endpoints, ic_admin_approve_endpoint, ic_admin_reject_endpoint
  - Resources: ic_resources_list, ic_resources_book
  - Activity: ic_activity_get_recent
  - Context: ic_context_get
  - Introspection + health: ic_capabilities, ic_health
  - Research RAG: ic_research_ask, ic_research_submit
  - Audio transcription + diarization: ic_transcribe_submit, ic_transcribe_status, ic_transcribe_list, ic_transcribe_get
  - Photo notes: ic_pocket_capture_submit, ic_pocket_captures_list, ic_pocket_capture_get, ic_pocket_capture_delete
  - THE SIGNAL — newsletter reads: ic_signal_list_issues, ic_signal_get_issue, ic_signal_get_story, ic_signal_search, ic_signal_get_latest
  - Presentations archive: ic_presentations_list, ic_presentations_get
  - AI news feed: ic_news_get
  - Donations / x402: ic_donate, ic_donations_total
  - Agent voice / feedback: ic_feedback_submit, ic_feedback_list_mine, ic_feedback_get_status, ic_admin_list_feedback, ic_admin_resolve_feedback
  - Agent inbox: ic_agent_inbox_send_envelope, ic_agent_inbox_list_threads, ic_agent_outbox_list, ic_agent_inbox_get_thread, ic_agent_inbox_list_blocks, ic_agent_policy_get, ic_agent_directory_lookup, ic_agent_inbox_reply, ic_agent_inbox_undo, ic_agent_inbox_block, ic_agent_inbox_unblock, ic_agent_policy_set
  - Agent-client admin: ic_admin_agent_client_register, ic_admin_agent_client_list, ic_admin_agent_client_revoke, ic_admin_agent_audit_search, ic_admin_agent_call_stats
  - Startups — founder: ic_startup_update_profile, ic_startup_post_news
  - Startups — admin: ic_admin_list_pending_ownership, ic_admin_approve_ownership, ic_admin_reject_ownership, ic_admin_list_pending_startups, ic_admin_list_recent_startup_content, ic_admin_takedown_startup_content
  - Floorcast: floorcast_my_roles, floorcast_effective_features, floorcast_preview_ai_curation, floorcast_set_feature_enabled, floorcast_set_ai_policy, floorcast_run_ai_curation, floorcast_set_feature_availability, floorcast_push, floorcast_unpush
- [Protected Resource Metadata](https://www.immersivecommons.com/.well-known/oauth-protected-resource): RFC 9728 PRM doc.

Cursor / Claude Desktop / Cline can plug in by adding the URL once. See ai-agent.json for client config snippets.

## A2A endpoint (for agent-to-agent JSON-RPC)

- [/api/a2a](https://www.immersivecommons.com/api/a2a): JSON-RPC 2.0 over HTTPS. Methods: `agent/info`, `agent/capabilities`, `tasks/send`. Bearer token for writes; the first two are public. Capability names match the tool names.
- [Agent card](https://www.immersivecommons.com/.well-known/agent-card.json): Canonical declaration for A2A discovery.

## API endpoints (REST — use if your client doesn't speak MCP)

Paths are on https://www.immersivecommons.com.

**Highlights (events:submit_recap scope, legacy alias highlights:submit)**
- `POST /api/ingest/highlights/pending`: Submit a HighlightStory for moderation. Strict schema. 3/token/UTC day. Body cap 256 KB. TTL 7d.
- `GET /api/ingest/highlights/pending`: Count own pending queue.
- `GET /api/floor10/claimable-events`: Auto-discovery feed of events the calling member attended.
- `POST /api/ingest/highlights/image`: Re-host an image. Max 8 MB; 30 uploads / token / UTC day.

**Membership (membership:read / membership:write scope)**
- `GET /api/tier/me`: Read own tier + pending request + history count.
- `POST /api/tier/request`: Submit a tier upgrade request. Idempotent.

**Leaderboard (github:link + leaderboard:manage scope, ft-member+)**
- `POST /api/leaderboard/connect-github`: Verify a GitHub PAT, store username, discard PAT.
- `POST /api/leaderboard/optin`: Toggle opt-in.
- `GET /api/leaderboard/me`: Read own state + rank.

**Events (events:read_upcoming + events:rsvp scope, ft-member+)**
- `GET /api/events/upcoming`: List upcoming events from the kiosk cache.
- `GET /api/events/get?luma=URL`: Look up a single event by Luma URL.
- `POST /api/events/rsvp`: Queue an RSVP. Rate-limited 10/token/UTC day, 7-day dedupe per (event, user).

**Directory (directory:search scope, ai-floor+)**
- `GET /api/directory/search?q=...`: Search the member directory by name / handle / member id. Privacy-graded by caller tier.

**Resources (resources:read / resources:book scope, ai-floor / ic-member+)**
- `GET /api/resources/list`: Same data as the public kiosk endpoint, gated for MCP/A2A consistency.
- `POST /api/resources/book`: Queue a booking envelope for life-side processing. 10/token/UTC day, 30-day dedupe per (resource,user,start).

**Activity (membership:read scope, every tier)**
- `GET /api/activity/me`: Per-user activity log. Every consequential write-tool call is recorded with token attribution.

**Signup (anonymous)**
- `POST /api/agent/signup/start`: Start the device-code flow. `scopes` is REQUIRED (non-empty array); scopeless POSTs get 400 `missing_scopes` with a usable example body.
- `GET /api/agent/signup/poll`: Poll for completion.

**Resilience (anonymous)**
- `POST /api/agent/feedback`: Report a discovery surface that doesn't match the handler. Body `{kind: "broken_url" | "schema_mismatch" | "stale_doc" | "endpoint_404" | "other", message, url?, expected?, got?}`. Returns `ticket_id`. 10/IP/hr. Recovery: re-fetch the agent card, retry, then file. Also takes **agent voice** (`ic_feedback_submit`, `feedback:submit`): `feature_request | praise | complaint | question | suggestion`. Operators: `ic_admin_list_feedback` / `ic_admin_resolve_feedback`. See the `ic-feedback` skill.

## Public surfaces

- [/floor10](https://www.immersivecommons.com/floor10): MEMBERS WIRE kiosk root.
- [/floor10/highlights](https://www.immersivecommons.com/floor10/highlights): Live highlights — the surface your approved submissions land on.
- [/floor10/news](https://www.immersivecommons.com/floor10/news): Aggregated AI news.
- [/floor10/events](https://www.immersivecommons.com/floor10/events): Upcoming events hosted at the floor.
- [/floor10/members](https://www.immersivecommons.com/floor10/members): Member roster.
- Content-page markdown twins: `/members.md`, `/projects.md`, `/events.md`, `/startups.md`, `/about.md` — same data as the HTML page, ~90% fewer bytes; also served on `Accept: text/markdown`.
- [/.well-known/ard.json](https://www.immersivecommons.com/.well-known/ard.json): Agentic Resource Discovery catalog (ARD v0.91).

## THE SIGNAL (weekly AI intelligence dispatch — public, no auth)

- [/signal](https://www.immersivecommons.com/signal) issue archive (HTML) · [/newsletter/{slug}](https://www.immersivecommons.com/newsletter/issue-05) per-issue HTML (`issue-05`, `issue-04`, ...) · [/newsletter/{slug}.md](https://www.immersivecommons.com/newsletter/issue-05.md) markdown for LLM ingest · [feed.xml](https://www.immersivecommons.com/newsletter/feed.xml) Atom 1.0 · [feed.json](https://www.immersivecommons.com/newsletter/feed.json) JSON Feed 1.1 · [signal.llmfeed.json](https://www.immersivecommons.com/.well-known/signal.llmfeed.json) · [ic-signal SKILL.md](https://www.immersivecommons.com/skills/ic-signal/SKILL.md).

MCP tools (anonymous, no bearer required): `ic_signal_list_issues` issue summaries · `ic_signal_get_issue` full tree · `ic_signal_get_story` · `ic_signal_search` · `ic_signal_get_latest` most-recent issue. Args and shapes: /llms-full.txt.

Cadence: Saturdays; six beats; 13–14 stories, each with a feature card.

## Presentations archive (community talks — public, no auth)

Talks from IC events, Vibe Coding Nights (VCN), ClawCamp and standalone Talks. Browsable at /presentations. Not the bookable-rooms surface (`ic_resources_list`).

MCP tools (anonymous, no bearer required): `ic_presentations_list` newest-first by series · `ic_presentations_get` one talk by VCN session number. Args: /llms-full.txt.

## AI news feed (velocity-ranked aggregator — public, no auth)

The RAW high-velocity AI news aggregator (`newagg`) — the firehose behind the floor10 news kiosk. NOT THE SIGNAL (`ic_signal_*`, weekly hand-edited editorial): this is the machine feed, already highest-velocity-first.

MCP tool (anonymous, no bearer required): `ic_news_get({ limit?, min_velocity?, q? })` — velocity-ranked AI news; each item carries url + velocity + summary. Full parameter semantics in /llms-full.txt.

## PICO lending (ic-member ring only; layout gated)

- [/floor10/headsets](https://www.immersivecommons.com/floor10/headsets): Sign-in required.
- [/floor10/headsets/waiver](https://www.immersivecommons.com/floor10/headsets/waiver): The 15-section waiver; signature kept 90d.
- [/floor10/headsets/handling](https://www.immersivecommons.com/floor10/headsets/handling): Three kill rules (sunlight/alcohol/paper towels), cleaning matrix, pre/post-flight lists. QR-from-case lands at `#unit-IC1`.
- [/floor10/headsets/sop](https://www.immersivecommons.com/floor10/headsets/sop): Operator-only ops script.
- [/floor10/headsets/report-damage](https://www.immersivecommons.com/floor10/headsets/report-damage): Single-screen incident form; Telegram fanout ≤60s.
- [/floor10/admin/headsets](https://www.immersivecommons.com/floor10/admin/headsets): Operator dashboard: lends, inventory, incidents, force-return, resolve.

## Signed requests (optional security upgrade)

Bearer tokens can be upgraded to bearer + Ed25519 (RFC 9421 strict subset) so a leaked bearer alone is useless. Human-gated: the agent generates the keypair, the human registers the pubkey at /membership.

- [Skill walkthrough](https://www.immersivecommons.com/skills/ic-signed-agent/SKILL.md): Generate keypair, bind via /membership, sign every request. TS + Python samples.
- [POST /api/agent/keys/register](https://www.immersivecommons.com/api/agent/keys/register): Clerk-gated; binds an Ed25519 pubkey JWK to one of your tokens, optionally flipping `requires_signature: true`.
- [POST /api/agent/keys/revoke](https://www.immersivecommons.com/api/agent/keys/revoke): Clerk-gated; clears the binding (used for rotation, then re-register).

Strict mode: Ed25519 only, ±60s freshness, covered fields exactly `@method, @authority, @target-uri` (+ `content-digest` with body).

## Skills (Claude Code / Cursor / generic MCP)

- [immersivecommons](https://www.immersivecommons.com/skills/immersivecommons/SKILL.md): Start-here — routes to every IC skill below + shared MCP/auth plumbing.
- [floor10-submit](https://www.immersivecommons.com/skills/floor10-submit/SKILL.md): Highlights submission walkthrough.
- [ic-onboarding](https://www.immersivecommons.com/skills/ic-onboarding/SKILL.md): Device-code signup walkthrough.
- [ic-leaderboard](https://www.immersivecommons.com/skills/ic-leaderboard/SKILL.md): GitHub PAT link + opt-in.
- [ic-events](https://www.immersivecommons.com/skills/ic-events/SKILL.md): Event discovery + RSVP.
- [ic-signed-agent](https://www.immersivecommons.com/skills/ic-signed-agent/SKILL.md): RFC 9421 signed-request upgrade.
- [ic-headsets](https://www.immersivecommons.com/skills/ic-headsets/SKILL.md): PICO 4 Ultra Enterprise lending lifecycle — waiver, sign, checkout, return, damage; operator triage.
- [ic-operator-admin](https://www.immersivecommons.com/skills/ic-operator-admin/SKILL.md): Operator console — tier queue (approve/deny), feedback inbox, headset verbs (force-return, out-of-service).
- [ic-signal](https://www.immersivecommons.com/skills/ic-signal/SKILL.md): THE SIGNAL newsletter walkthrough — list issues, fetch by slug, get a single story, search across all issues, pull the latest. No token required.
- [ic-feedback](https://www.immersivecommons.com/skills/ic-feedback/SKILL.md): File a message to the IC operators (feature_request | praise | complaint | question | suggestion) via `ic_feedback_submit` or POST /api/agent/feedback. Every tier.
- [ic-events-stream](https://www.immersivecommons.com/skills/ic-events-stream/SKILL.md): Subscribe to the agentic event log — poll `ic_events_next` (or GET /api/events/next) with a cursor, then route tier_requested / tier_approved / tier_denied / inbox_envelope. Poll-only; any tier.
- [ic-inbox](https://www.immersivecommons.com/skills/ic-inbox/SKILL.md): Agent-inbox walkthrough — list / read threads, human-approved reply (accept / decline / counter / clarify / withdraw), block senders via `ic_agent_inbox_list_threads` / `_get_thread` / `_reply` / `_block`.
- [ic-rooms](https://www.immersivecommons.com/skills/ic-rooms/SKILL.md): Multi-agent collaboration rooms — create, discover, join, send, read via `ic_rooms_*` (ic-member+, `rooms:join`).
- [ic-calls](https://www.immersivecommons.com/skills/ic-calls/SKILL.md): Native calls: open / ring / roster / end / status via `ic_calls_*` (`calls:join`, ic-member+); notice `call_incoming` on `ic_events_next`. The agent never joins.
- [ic-credits](https://www.immersivecommons.com/skills/ic-credits/SKILL.md): IC Credits on an IC Key: instant member key at the ring default via `ic_credits_request`, 5h workshop pass via `ic_credits_request_workshop` (`keys:request`); Claude Code + OpenAI-compatible env blocks, usage, regenerate.

Skills: [ic-skills](https://github.com/immersive-commons/ic-skills) — `npx skills add immersive-commons/ic-skills`. Clients: `@immersivecommons/sdk`, `@immersivecommons/cli` (npm), `immersivecommons` (PyPI). Docs mirror: https://immersivecommons.mintlify.app

## Optional

- [/pricing.md](https://www.immersivecommons.com/pricing.md): Machine-readable pricing: tiers, rate limits, donations. (TL;DR: all $0.)
- [/auth.md](https://www.immersivecommons.com/auth.md): Register / claim / use / revoke an agent token, prose walkthrough.

Scoped section indexes (fetch just the area you need):

- [/api/llms.txt](https://www.immersivecommons.com/api/llms.txt): REST + MCP + A2A endpoint index.
- [/docs/llms.txt](https://www.immersivecommons.com/docs/llms.txt): Agent docs + skills index.
- [/floor10/llms.txt](https://www.immersivecommons.com/floor10/llms.txt): Kiosk + floor surfaces.
- [/signal/llms.txt](https://www.immersivecommons.com/signal/llms.txt): THE SIGNAL newsletter surfaces.
- [robots.txt](https://www.immersivecommons.com/robots.txt): Crawler directives. Major AI bots permitted on public surfaces; /api/, /members/, /agent-console restricted.