Mockya API Documentation
Mockya provides standard REST endpoints and agent-ready discovery mechanisms including RFC 9727 API Catalog, OpenAPI 3.1 schema, RFC 9728 OAuth Protected Resource Metadata, and WebMCP browser tools.
Discovery & Well-Known Endpoints
Mockya supports modern automated agent and protocol discovery:
- API Catalog (RFC 9727):
/.well-known/api-catalog(application/linkset+json) - Agentic Resource Discovery (ARD):
/.well-known/ai-catalog.json - MCP Server Card (SEP-1649):
/.well-known/mcp/server-card.json - Agent Skills Index (RFC v0.2.0):
/.well-known/agent-skills/index.json - Personal Agent Protocol (Poppy):
/.well-known/poppy.json - Agent Auth Guidance:
/auth.md - OAuth Protected Resource (RFC 9728):
/.well-known/oauth-protected-resource - OAuth Authorization Server (RFC 8414):
/.well-known/oauth-authorization-server
Core Endpoints
| Method | Endpoint | Description |
|---|---|---|
GET | /api/status | Health check and operational status |
GET | /api/auth/me | Get active user session and credit balance |
POST | /api/credits/deduct | Deduct export credits after render completes |
POST | /api/feedback | Submit feedback or user rating |