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, use the sponsored free route, or fulfill the x402 payment challenge returned by a paid request.

Sandbox & free tier

Test with zero credentials: curl https://surp.ivc.lol/v1/models (no auth), then call surp/free for sponsored zero-cost inference within the daily cap. Get a self-serve free-tier key with elevated budgets via curl -X POST https://surp.ivc.lol/api/free-key -H 'Content-Type: application/json' -d '{"label":"sandbox"}' — no signup, no 'contact sales'. Prepaid keys are created the same way in the account app.

Operations

See pricing, service status, privacy, and developer support.