> ## Documentation Index
> Fetch the complete documentation index at: https://immersivecommons.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# immersivecommons.com API Documentation

> Immersive Commons is Floor 10 of Frontier Tower SF — a members-run space for AI builders. This is the human-browsable index of every developer resource.

Everything a human can do on [immersivecommons.com](https://www.immersivecommons.com) an agent can do through the API: one per-user token, three equivalent transports (REST, MCP, A2A), and 138 typed capabilities.

Free to call. Public read tools need no account. Writes need a human-approved token — see [Authentication](/auth).

Agents can start from [llms.txt](https://www.immersivecommons.com/llms.txt) instead of this page.

## immersivecommons.com Developer Portal

Quickstart, authentication, a live endpoint reference generated from the OpenAPI spec, rate limits, and the sandbox — the guided, human-readable entry point to the Immersive Commons agent API.

<Card title="Developer Portal" icon="book-open" href="/developers">
  immersivecommons.com/developers
</Card>

## immersivecommons.com API Reference (OpenAPI 3.1)

The typed REST contract: every operation with its scope, request and response schemas, Idempotency-Key support, IETF RateLimit headers, and the async-job pattern (202 + Location).

<Card title="API Reference" icon="code" href="/api-reference">
  immersivecommons.com/openapi.json
</Card>

## immersivecommons.com Authentication Docs

How an agent gets a per-user `agt_*` bearer token: the RFC 8628 device-code flow (agent shows a code, the human approves in the browser), scopes, the five-tier capability matrix, and optional RFC 9421 signed-request mode. Agents cannot self-mint.

<Card title="Authentication" icon="key" href="/auth">
  immersivecommons.com/auth.md
</Card>

## immersivecommons.com MCP Server

Streamable HTTP MCP endpoint at `/api/mcp` — 138 tools, 10 of them public with no token (THE SIGNAL newsletter, the AI news feed, the presentations archive, x402 donations). Discovery manifest at [/.well-known/mcp.json](https://www.immersivecommons.com/.well-known/mcp.json), server card at [/.well-known/mcp/server-card.json](https://www.immersivecommons.com/.well-known/mcp/server-card.json). Registry listings: [official MCP registry (com.immersivecommons/floor10)](https://registry.modelcontextprotocol.io/v0/servers?search=com.immersivecommons) · [Smithery](https://smithery.ai/servers/admin-oc72/immersive-commons-floor10).

## immersivecommons.com A2A Agent Card

Agent-to-agent (A2A) discovery card for the JSON-RPC 2.0 endpoint at `/api/a2a` — the same capabilities as MCP and REST behind the same token. [/.well-known/agent-card.json](https://www.immersivecommons.com/.well-known/agent-card.json)

## immersivecommons.com Agent Skills

Thirteen drop-in skill walkthroughs (onboarding, events, headsets, rooms, inbox, and more) for Claude Code, Cursor, and other skill-aware agents. Cataloged in [/.well-known/ai-agent.json](https://www.immersivecommons.com/.well-known/ai-agent.json), mirrored on [GitHub (immersive-commons/ic-skills)](https://github.com/immersive-commons/ic-skills).

```
npx skills add immersive-commons/ic-skills
```

## immersivecommons.com Agent Manifest & llms.txt

The one-fetch reading list for agents ([llms.txt](https://www.immersivecommons.com/llms.txt) + long-form [llms-full.txt](https://www.immersivecommons.com/llms-full.txt)) and the machine-readable agent manifest at [/.well-known/ai-agent.json](https://www.immersivecommons.com/.well-known/ai-agent.json): auth scheme, scope catalog, endpoints, rate limits, and the device-code signup URL. Agentic Resource Discovery catalog at [/.well-known/ai-catalog.json](https://www.immersivecommons.com/.well-known/ai-catalog.json).

## Official SDKs

Generated from the same [OpenAPI 3.1 spec](/api-reference):

* `@immersivecommons/sdk` + `@immersivecommons/cli` — [npm](https://www.npmjs.com/package/@immersivecommons/sdk)
* `immersivecommons` — [PyPI](https://pypi.org/project/immersivecommons/)
* `github.com/immersive-commons/ic-go` — [Go modules](https://pkg.go.dev/github.com/immersive-commons/ic-go)
* `immersivecommons` — [RubyGems](https://rubygems.org/gems/immersivecommons)

***

Immersive Commons · FT10 · San Francisco · [LinkedIn](https://www.linkedin.com/company/immersivecommons) · [X](https://x.com/immersivecommon) · [GitHub](https://github.com/immersive-commons)
