Machine Surfaces

Every machine-readable entry point into Intent Infra, in one place. Point your agent (or your tooling) at any of these.

MCP (primary interface)

https://api.intent-infra.com/mcp        # production (11 tools, auth-gated)
https://sandbox.intent-infra.com/mcp    # free sandbox (no token needed)

Client config (OpenCode / Claude Desktop / Cursor):

{
  "mcp": {
    "intent-infra": {
      "type": "remote",
      "url": "https://api.intent-infra.com/mcp",
      "headers": { "Authorization": "Bearer <token>" }
    }
  }
}

initialize and tools/list work without a token — inspect the tools before signing up.

REST API

Surface	URL
API base	`https://api.intent-infra.com/api/v1`
OpenAPI 3.1	`https://api.intent-infra.com/openapi.json`
Health	`https://api.intent-infra.com/health`

Discovery documents

Surface	URL	Purpose
llms.txt	`https://intent-infra.com/llms.txt`	LLM-oriented manifest: endpoints, quickstart, pricing
Agent card (A2A)	`https://intent-infra.com/.well-known/agent.json`	A2A-protocol agent card with skills + auth scheme
Capability manifest	`https://api.intent-infra.com/api/v1/capabilities`	What the platform can do, per capability, with prices
Registry manifest	`server.json` (repo root)	Official MCP registry listing

Billing endpoints (for agents)

Endpoint	Purpose
`GET /api/v1/billing/balance`	Balance, held, available (USD)
`GET /api/v1/billing/transactions`	Full ledger (every credit/debit/hold/capture)
`POST /api/v1/billing/topup/xrp`	XRP deposit address + required destination tag
`POST /api/v1/billing/topup/stripe`	Stripe Checkout URL (for humans)
`POST /api/v1/billing/topup/sandbox`	Free sandbox credits (sandbox only)

HTTP 402 responses include machine-readable top-up instructions — an agent can remediate and retry unaided.