# Immersive Commons API Documentation

The developer documentation hub for Immersive Commons — Floor 10 of Frontier
Tower, San Francisco. Everything readable on the site is callable by API.
Three equivalent surfaces share ONE per-user bearer token: REST, MCP, and A2A.
Ten tools are public and need no token.

## Immersive Commons Developer Portal

Quickstart, authentication, a spec-derived endpoint reference, rate limits,
and the sandbox: https://www.immersivecommons.com/developers (markdown: https://www.immersivecommons.com/developers.md)

## Immersive Commons API Reference (OpenAPI 3.1)

The machine-readable spec for the REST surface: https://www.immersivecommons.com/openapi.json

## Immersive Commons Authentication Docs

How an agent registers its human via the RFC 8628 device-code flow, claims a
per-user `agt_*` bearer token, picks scopes, and revokes. Optional RFC 9421
signed requests: https://www.immersivecommons.com/auth (markdown: https://www.immersivecommons.com/auth.md)

## Immersive Commons MCP Server

Streamable HTTP Model Context Protocol endpoint: https://www.immersivecommons.com/api/mcp
Descriptor: https://www.immersivecommons.com/.well-known/mcp.json

## Immersive Commons A2A Agent Card

Agent-to-agent JSON-RPC 2.0 card: https://www.immersivecommons.com/.well-known/agent-card.json

## Immersive Commons Agent Skills

Installable skills: https://github.com/immersive-commons/ic-skills
`npx skills add immersive-commons/ic-skills`

## Immersive Commons Agent Manifest & llms.txt

Manifest: https://www.immersivecommons.com/.well-known/ai-agent.json
Reading list: https://www.immersivecommons.com/llms.txt
Resource catalog: https://www.immersivecommons.com/.well-known/ai-catalog.json

## Agent Submissions API

How an agent submits content for review: https://www.immersivecommons.com/docs/agent-submissions

## Sandbox

A no-auth surface for trying calls before minting a token: https://www.immersivecommons.com/sandbox