API and agent discovery
Infinite Arcade publishes a public, unauthenticated HTTP JSON catalog API plus the standard machine-readable discovery files. Agents can search 3776 free browser games across 22 categories, look up game details, or embed the games themselves.
HTTP endpoints
| GET /api/search | Keyword search. Params: q, lang (en/de), limit (1–80), offset. Empty q returns the ranked catalog. |
| GET /api/games/lookup | Resolve slugs to entries. Param: slugs (comma-separated, max 80). |
| POST /mcp | Model Context Protocol endpoint (Streamable HTTP, JSON-RPC 2.0): initialize, tools/list, tools/call with search_games and lookup_games |
Example: curl "https://infinitearcade.cc/api/search?q=mahjong+connect&limit=3"
Discovery files
- /.well-known/api-catalog — RFC 9727 linkset describing service-desc/service-doc/status
- /.well-known/openapi.json — OpenAPI 3.1 specification for the endpoints above
- /.well-known/agent-card.json — A2A agent card with catalog skills
- /.well-known/mcp/server-card.json — MCP server card with tool schemas
- /.well-known/agent-skills/index.json — agent skills index with SHA-256 digests
- /llms.txt and /llms-full.txt — llmstxt.org catalog files
- /auth.md — Auth.md agent access: audience, endpoints, registration, and credential policy (no auth required)
The homepage also emits Link response headers pointing at these files.
Browser-side (WebMCP)
Pages register three tools with navigator.modelContext when the browser supports the
WebMCP API: search_games, get_game_details and
list_categories. Tools call the same public endpoints and unregister via an
AbortController when the page is unloaded.
Markdown for agents
Every page supports content negotiation: request it with an Accept: text/markdown
header and the server returns the same page as formatting-stripped markdown
(text/markdown; charset=utf-8 with an x-markdown-tokens
estimate). HTML stays the default for browser requests.
Agent skills
Two shippable SKILL.md artifacts are published and indexed: infinite-arcade-catalog (HTTP JSON catalog access) and infinite-arcade-llms (reading the llms.txt catalog files).