Developer and agent reference

JellyStreamz API

JellyStreamz exposes a small, read-only public surface for product releases and the community game metadata catalog. Public endpoints do not reveal anyone's Jellyfin server, private library, account preferences, or supporter credentials.

Discovery

API catalog

/.well-known/api-catalog

OpenAPI 3.1

/openapi.json

Health

/api/health/

Agent reference

/llms-full.txt

Public HTTP endpoints

GET /api/v1/agent/games/?q=metroid&system=nes searches the public game database. GET /api/v1/agent/games/?platforms=1 lists platforms. GET /api/v1/games/?id=361 returns a full game record. GET /api/v1/community/ returns current release and platform availability.

MCP

The read-only MCP Streamable HTTP endpoint is POST /mcp/. Start with initialize, then use tools/list or resources/list. The server card advertises current capabilities.

A2A

The A2A Agent Card describes the JSON-RPC service at POST /a2a/. It supports read-only game search and release questions.

Authentication

Public catalog and release reads are anonymous. Approved clients can use OAuth 2.0 Authorization Code with PKCE for the member profile endpoint. Read the auth.md guide and the protected resource metadata before requesting access.

Limits and use

Clients should honor cache headers, keep search limits at 30 or fewer records, and avoid repeated identical requests. The public content policy is ai-train=no, search=yes, ai-input=yes.