Surp Developer Portal

Build agent and application integrations with Surp's [OI]-compatible AI inference router.

Core developer resources

• Surp API documentation — authentication, endpoints, x402 payment flow, pricing, streaming, and examples.
• Surp OpenAPI 3.1 specification — typed requests, responses, operation IDs, and error models.
• Surp agent authentication guide — prepaid Bearer keys and x402 payment signatures.
• Surp MCP manifest and MCP Server Card.
• Surp MCP server — live Streamable HTTP endpoint (initialize, tools, resources).
• API versioning & deprecation policy — URL versioning, Deprecation and Sunset headers.
• Surp A2A Agent Card and Agent Skills index.
• Surp llms.txt — concise instructions for agents.

Start building

Use https://surp.ivc.lol/v1 as the base URL. List routes with GET /v1/models and submit completions to POST /v1/chat/completions. Create a self-serve key in the Surp account app, or fulfill the x402 payment challenge returned by a paid request.

Sandbox

Test with zero credentials: curl https://surp.ivc.lol/v1/models (no auth), then browse live prices at /prices and pick a combo. Paid requests cost from $0.01: create a prepaid key in the account app or complete an x402 challenge.

Operations

See pricing, service status, terms of service, operator identity, privacy, and developer support.