# JellyStreamz agent reference

## What JellyStreamz is

JellyStreamz is an independent client experience for personal Jellyfin servers. The Android family includes television, Google TV, NVIDIA Shield, phone, tablet, Android Auto, casting, offline downloads, and a gaming frontend. Native Apple and Nintendo work is described on the Apps and Future pages.

The gaming frontend can scan user-owned local, removable, network, or Jellyfin-plugin-backed libraries. It matches ROM fingerprints and filenames to the JellyStreamz public metadata catalog, downloads selected artwork, checks configured BIOS files, integrates optional RetroAchievements information, and launches a separately installed emulator. The project does not distribute ROMs, BIOS files, or emulators as part of the app.

## Public knowledge surfaces

The website provides conventional HTML by default. Public pages return Markdown when a client sends `Accept: text/markdown`. The response includes `X-Markdown-Tokens`, `X-Original-Tokens`, `Content-Location`, and the site Content Signal policy.

The public OpenAPI document is at `https://jellystreamz.com/openapi.json`. The RFC 9727 API catalog is at `https://jellystreamz.com/.well-known/api-catalog`.

Useful read-only operations:

- `GET /api/v1/games/?id={id}` gets one public game record.
- `GET /api/v1/games/?system={slug}&q={title}&limit={n}` searches within a platform.
- `GET /api/v1/agent/games/?q={title}&system={slug}&limit={n}` searches across platforms and returns a compact agent-oriented result.
- `GET /api/v1/agent/games/?platforms=1` lists public platforms.
- `GET /api/v1/community/` returns current release and platform availability information.
- `GET /api/health/` reports public API health.

The public MCP Streamable HTTP endpoint is `POST https://jellystreamz.com/mcp/`. It supports initialization, tool discovery, tool calls, and public resource reads. It does not expose account changes, moderation, downloads, or private Jellyfin data.

The A2A JSON-RPC endpoint is `POST https://jellystreamz.com/a2a/`. Its agent card is at `/.well-known/agent-card.json`.

## Accounts and authentication

Reading public product information, release information, game metadata, and public community requests does not require an account.

Website accounts are required to vote, submit issues or feature ideas, contribute game records or artwork, and manage supporter entitlements. Browser users authenticate through the first-party sign-in flow.

OAuth 2.0 Authorization Code with PKCE is available for approved agent clients. Discovery metadata, registration information, scopes, and examples are documented in `/auth.md`.

## Accuracy notes

App availability, download versions, plugin versions, game counts, community request states, and future plans can change. Prefer the linked live pages and APIs over cached descriptions. Game metadata and artwork may include community contributions that are moderated before publication.

## Content and safety policy

The public policy is `ai-train=no, search=yes, ai-input=yes`. Agents may use public content to answer a user's request and may index public pages for search, but JellyStreamz does not grant model-training permission. Private account, admin, authentication, contribution, and download authorization routes are excluded from crawling in robots.txt.