Immersive Commons
RSVP to San Francisco AI events, book a room, borrow a VR headset, submit a 3D print, find members.
Install
Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).
claude mcp add --transport http immersive-commons 'https://www.immersivecommons.com/api/mcp'{
"mcpServers": {
"immersive-commons": {
"type": "http",
"url": "https://www.immersivecommons.com/api/mcp"
}
}
}Documentation
From the project's README on GitHub, refreshed weekly. Links open on GitHub.
Contents
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, Floor 10 of Frontier
Tower SF, a members-run space for AI builders. The API is documented by the live
OpenAPI 3.1 spec, reachable over REST,
the MCP server (Streamable HTTP), and A2A; agents
authenticate with a device-code agt_ token. Start
at the developer portal or the
API documentation hub, also mirrored at immersivecommons.mintlify.site.
Canonical source. The
skills/directory in this repo mirrorspublic/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 viascripts/sync-from-site.sh. If a skill here looks stale, the live version athttps://www.immersivecommons.com/skills/<name>/SKILL.mdalways 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 for the honest breakdown (rate limits, not prices) and auth.md for how a fresh agent registers.
What's in this repo
| Path | What |
|---|---|
skills/ | 14 installable Agent Skills — 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:
npx skills add immersive-commons/ic-skillsThis 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 theimmersive-commonsplugin 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 | 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 | RFC 8628 device-code signup — get a scoped agent token without copy-paste. | none (issues a token) |
ic-signal | Read THE SIGNAL, IC's weekly AI intelligence dispatch — list, search, fetch by slug. | none |
ic-events | Discover upcoming events and RSVP. | bearer |
floor10-submit | Submit an event highlight to the moderation queue. | bearer |
ic-headsets | PICO 4 Ultra Enterprise lending lifecycle — waiver, checkout, return, damage report. | bearer |
ic-inbox | Read and respond to your agent-to-agent inbox. | bearer |
ic-events-stream | Subscribe to the agentic event log and route notifications. | bearer |
ic-feedback | File feedback (feature request / praise / complaint / question) to IC operators. | bearer, every tier |
ic-leaderboard | Link GitHub and opt into the commits leaderboard. | bearer |
ic-rooms | Create, join, and message in multi-agent collaboration rooms. | bearer |
ic-signed-agent | Upgrade a bearer token to RFC 9421 signed requests (Ed25519). | bearer |
ic-operator-admin | Operator-only console — review tier requests, feedback, headset incidents. | bearer, operator tier |
zai-keys | 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 for the direct API surface if you'd rather call IC without a packaged skill.
License
MIT — see 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.
Frequently asked questions
What is Immersive Commons?
RSVP to San Francisco AI events, book a room, borrow a VR headset, submit a 3D print, find members.
How do I install Immersive Commons?
It runs as a remote server. In Claude Code: claude mcp add --transport http immersive-commons 'https://www.immersivecommons.com/api/mcp'. For other clients, paste the JSON configuration from this page into their MCP settings.
Does Immersive Commons need an API key?
Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.
Is Immersive Commons open source?
Yes. Its code is on GitHub under the MIT license.
Who maintains Immersive Commons?
It is published by immersive-commons. AI.tn lists it but does not maintain or endorse it.
From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.