Documentation

1. What is offered through StableMedia?

StableMedia is a pay-per-request proxy to the Streaming Availability API (Movie of the Night). Search shows by title or filters, look up countries and their streaming services, and list genres — across 60+ countries and 200+ services. All endpoints require USDC micropayments on Base or Solana. For exact route specifications, see llms.txt.

2. How to use with an AI agent of my choice?

StableMedia endpoints can be called through the agentcash-skills MCP server or CLI, which handles payment processing automatically.

Installation

Claude Code

npx agentcash install

Wallet Setup

On first run, the MCP server generates a wallet at ~/.agentcash/wallet.json. Deposit USDC on Base or Solana to that address before making paid API calls.

3. System Prompt Tips

A minimal system prompt for Claude or other agents:

System Prompt

You have access to the agentcash MCP server for paid x402 API calls.

Use this progressive workflow:

1. Start with mcp__agentcash__discover_api_endpoints on https://stablemedia.dev
2. If discovery returns guidanceAvailable=true but guidance is omitted, re-run with include_guidance=true.
3. Before first POST fetch to a selected endpoint, call mcp__agentcash__check_endpoint_schema.
4. Execute with mcp__agentcash__fetch.

Endpoints available on https://stablemedia.dev (all POST, body is JSON):
- /api/shows/search-title   — search shows by title + country
- /api/shows/search-filters — catalog search (genres, year, rating, catalogs)
- /api/shows/get            — get a show by id / IMDb / TMDB
- /api/shows/top            — top shows on a service (netflix, prime, disney, apple, hbo)
- /api/countries/list       — list all supported countries + services
- /api/countries/get        — get one country by ISO 3166-1 alpha-2 code
- /api/genres/list          — list all genres

All endpoints cost $0.01 per request in USDC on Base or Solana.