# Wundership Agent-Payable API

Wundership provides machine-payable APIs for AI agents that need app planning, BuilderStudio preview preparation, image generation, chat completions, and AI commerce listing generation.

## Discovery
Agent page: https://api.wundership.com/agents
Agent card: https://api.wundership.com/.well-known/agent-card.json
MPP discovery: https://api.wundership.com/.well-known/mpp.json
MPP OpenAPI: https://api.wundership.com/openapi.json
Agent OpenAPI: https://api.wundership.com/openapi-agent.json
Product catalog: https://api.wundership.com/agent-products.json
Machine payments manifest: https://api.wundership.com/machine-payments.json

## Paid endpoints
POST https://api.wundership.com/mpp/plan
Price: 1.00 USD
Use case: Turn a software idea into a product brief, architecture outline, build phases, risks, and upsell path.

POST https://api.wundership.com/mpp/builder/preview
Price: 5.00 USD
Use case: Prepare a BuilderStudio preview package for an app idea.

POST https://api.wundership.com/mpp/images/generate
Price: 1.00 USD
Use case: Generate images through the Wundership image API after machine payment.

POST https://api.wundership.com/mpp/listings/from-image
Price: 0.75 USD
Use case: Generate commerce listing metadata from image input after machine payment.

POST https://api.wundership.com/mpp/chat/completions
Price: 0.50 USD
Use case: Generate chat completion output after machine payment.

## Payment behavior
A request without payment returns HTTP 402 Payment Required with machine-readable price and payment challenge metadata.
A payment proxy or MPP-compatible gateway should verify payment and forward the paid request to this API with a configured verification secret.

## Human upgrade path
Subscribe for persistent API keys, higher quotas, deployment access, managed BuilderStudio resources, and usage-based billing.