# Voidpet public discovery API

Voidpet exposes a small, read-only API for discovering its public products, pages, legal documents, and agent-facing metadata. It does not expose accounts, game state, or authenticated actions.

## Endpoints

- `GET /api/discovery` returns public site metadata and canonical URLs as JSON.
- `GET /api/health` returns the web discovery service's health as JSON.
- `POST /mcp` provides stateless Model Context Protocol tools for ranked public knowledge search, exact structured VoidDex entries, and page discovery.

The MCP knowledge catalog covers Voidpets and their lore, vivids and definitions, public character profiles, and blog metadata. Use `search_public_knowledge` to find entries and `get_public_knowledge_entry` for complete structured details.

The machine-readable OpenAPI description is available at `/.well-known/openapi.json`. The MCP server card is available at `/.well-known/mcp/server-card.json`.