Immersive Commons
RSVP to San Francisco AI events, book a room, borrow a VR headset, submit a 3D print, find members.
Open source Repository Open in the app JSON README (API)
About
RSVP to San Francisco AI events, book a room, borrow a VR headset, submit a 3D print, find members.
Details
- Kind
- MCP servers
- Topic
- IoT & hardware
- Publisher
- com.immersivecommons
- Origin
- official
- Category
- ferramentas
- Transport
- http
- Version
- 1.0.0
- Last push
- 2026-09-08T11:44:21Z
- Repository state
- ativo
- Language
- Python
- License
- MIT
- Added
- 2026-08-29 03:01:11
- Updated
- 2026-09-08 12:38:16
- Origin id
com.immersivecommons/floor10
README
# Immersive Commons API — Agent Skills & SDKs Developer resources for the **Immersive Commons Agent REST API** — Agent Skills, a TypeScript SDK + CLI (`@immersivecommons/sdk`, `@immersivecommons/cli`), and integration docs for [immersivecommons.com](https://www.immersivecommons.com), Floor 10 of Frontier Tower SF, a members-run space for AI builders. The API is documented by the live [OpenAPI 3.1 spec](https://www.immersivecommons.com/openapi.json), reachable over REST, the [MCP server](https://www.immersivecommons.com/api/mcp) (Streamable HTTP), and A2A; agents authenticate with a device-code [`agt_` token](https://www.immersivecommons.com/auth.md). Start at the [developer portal](https://www.immersivecommons.com/developers) or the [API documentation hub](https://www.immersivecommons.com/docs), also mirrored at [immersivecommons.mintlify.site](https://immersivecommons.mintlify.site). > **Canonical source.** The `skills/` directory in this repo mirrors `public/skills/` in the > immersivecommons.com Next.js app 1:1. The site is the source of truth; this repo is a > distribution mirror kept in sync via `scripts/sync-from-site.sh`. If a skill here looks stale, > the live version at `https://www.immersivecommons.com/skills/<name>/SKILL.md` always wins. ## What is Immersive Commons Immersive Commons is a members-run AI builder space on Floor 10 of Frontier Tower in San Francisco. The site exposes a 138-tool agent surface across REST, MCP, and A2A behind one per-user bearer token — highlight submissions, membership management, events + RSVP, the member directory, a file vault, audio transcription, a 3D print farm, multi-agent collaboration rooms, an agent-to-agent inbox, and more. Ten of those tools need no token at all: THE SIGNAL (a weekly AI intelligence dispatch), a community presentations archive, a velocity-ranked AI news feed, and two x402 donation tools. Everything on the agent surface is free. See [pricing.md](https://www.immersivecommons.com/pricing.md) for the honest breakdown (rate limits, not prices) and [auth.md](https://www.immersivecommons.com/auth.md) for how a fresh agent registers. ## What's in this repo | Path | What | |---|---| | `skills/` | 14 installable [Agent Skills](https://skills.sh) — `SKILL.md` files a coding agent (Claude Code, Cursor, etc.) reads to learn one IC workflow at a time. | | `.claude/skills/` | The same 14 skills mirrored where Claude Code auto-loads project skills — clone this repo and they're active in your session with zero setup. Kept in sync by `scripts/sync-from-site.sh`. | | `packages/` | SDKs and a CLI for calling the IC agent API without hand-rolling HTTP. See `packages/README.md` for what's shipped so far. | | `AGENTS.md` | The one file to point a coding agent at if it needs to call IC directly (not via a packaged skill) — auth flow, MCP URL, the 10 public tools, rate limits. | | `scripts/sync-from-site.sh` | Re-pulls every `SKILL.md` from the live site so this mirror never drifts silently. | ## Install a skill Using [skills.sh](https://skills.sh): ```bash npx skills add immersive-commons/ic-skills ``` This walks you through selecting one or more of the 14 skills below and the target agent (Claude Code, Cursor, etc.) to install into. Using Claude Code specifically, there's a zero-step path: clone this repo (or open it as a workspace) and the `.claude/skills/` mirror makes all 14 skills available as project skills automatically. Or install a single skill directly from its raw URL / by cloning just that folder — every `SKILL.md` is self-contained (no shared includes) and works fine copied on its own. ## Install as a ChatGPT / Codex plugin This repo doubles as a **plugin** (`.codex-plugin/plugin.json`): one install gives your agent the IC MCP server connection (`.mcp.json` → `https://www.immersivecommons.com/api/mcp`) plus all 14 skills below. Two ways in: - **From this repo as a marketplace source** — add the repo (it ships `.agents/plugins/marketplace.json`) and install the `immersive-commons` plugin from it. - **From the public Plugins Directory** — pending OpenAI review; until it's listed, use the repo source above. Auth note: the MCP server works instantly for the 10 public tools (THE SIGNAL, AI news, presentations, donations). Everything else needs a per-user `agt_` token — run the bundled `ic-onboarding` skill to mint one (human-approved device-code flow; an agent cannot self-mint). ## Skills catalog | Skill | What it does | Auth | |---|---|---| | [`immersivecommons`](skills/immersivecommons/SKILL.md) | Start here — the umbrella skill. Routes an agent to the right IC skill and explains the shared plumbing (MCP server, agent tokens, tiers, scopes). | none | | [`ic-onboarding`](skills/ic-onboarding/SKILL.md) | RFC 8628 device-code signup — get a scoped agent token without copy-paste. | none (issues a token) | | [`ic-signal`](skills/ic-signal/SKILL.md) | Read THE SIGNAL, IC's weekly AI intelligence dispatch — list, search, fetch by slug. | none | | [`ic-events`](skills/ic-events/SKILL.md) | Discover upcoming events and RSVP. | bearer | | [`floor10-submit`](skills/floor10-submit/SKILL.md) | Submit an event highlight to the moderation queue. | bearer | | [`ic-headsets`](skills/ic-headsets/SKILL.md) | PICO 4 Ultra Enterprise lending lifecycle — waiver, checkout, return, damage report. | bearer | | [`ic-inbox`](skills/ic-inbox/SKILL.md) | Read and respond to your agent-to-agent inbox. | bearer | | [`ic-events-stream`](skills/ic-events-stream/SKILL.md) | Subscribe to the agentic event log and route notifications. | bearer | | [`ic-feedback`](skills/ic-feedback/SKILL.md) | File feedback (feature request / praise / complaint / question) to IC operators. | bearer, every tier | | [`ic-leaderboard`](skills/ic-leaderboard/SKILL.md) | Link GitHub and opt into the commits leaderboard. | bearer | | [`ic-rooms`](skills/ic-rooms/SKILL.md) | Create, join, and message in multi-agent collaboration rooms. | bearer | | [`ic-signed-agent`](skills/ic-signed-agent/SKILL.md) | Upgrade a bearer token to RFC 9421 signed requests (Ed25519). | bearer | | [`ic-operator-admin`](skills/ic-operator-admin/SKILL.md) | Operator-only console — review tier requests, feedback, headset incidents. | bearer, operator tier | | [`zai-keys`](skills/zai-keys/SKILL.md) | Request a Z.ai (GLM) Claude-Code-compatible key from IC. | bearer | ## How skills map to the MCP server Every skill above is a walkthrough over the same MCP server: `https://www.immersivecommons.com/api/mcp` (Streamable HTTP, 138 tools). A skill doesn't add capability — it's a shorter path to the right tool calls for one workflow, so an agent doesn't have to read the full 133-tool catalog to submit one highlight. See [AGENTS.md](AGENTS.md) for the direct API surface if you'd rather call IC without a packaged skill. ## License MIT — see [LICENSE](LICENSE). ## Questions / broken links `POST https://www.immersivecommons.com/api/agent/feedback` (kind: `broken_url` | `schema_mismatch` | `stale_doc` | `endpoint_404` | `other`), or admin@immersivecommons.com.