API Reference

This API reference is auto-generated from our OpenAPI specification.

Overview

ASG Agent Cloud uses MCP (Model Context Protocol) over HTTP for tool execution. All endpoints accept JSON and return JSON.

Base URL

https://agent.asgcompute.com

Authentication

All requests require Bearer authentication with an API key (created in the Console):

Authorization: Bearer <api_key>

API keys use the sk-agent-* prefix. See Authentication for setup details.

Endpoints

Health

GET /health

Check service status. No authentication required.

MCP Gateway

POST /mcp

Execute MCP tool calls. Returns 402 with quote if payment needed.

Receipts

GET /receipts

List your payment receipts.

GET /receipts/{id}

Get a specific receipt by ID.

Runs

GET /runs

List your execution runs.

GET /runs/{id}

Get run details by ID.

OpenAPI Specification

The complete API specification is available at:

View OpenAPI YAML

Error Handling

All errors follow a consistent format. See Error Codes for the complete reference.

{
  "code": "QUOTE_EXPIRED",
  "message": "Quote has expired",
  "request_id": "req_abc123"
}

Rate Limits

Tier	Requests/min	Burst
Default	60	10
Enterprise	Custom	Custom

Rate limit headers are included in responses:

X-RateLimit-Limit
X-RateLimit-Remaining
X-RateLimit-Reset

​API Reference

​Overview

​Base URL

​Authentication

​Endpoints

​Health

GET /health

​MCP Gateway

POST /mcp

​Receipts

GET /receipts

GET /receipts/{id}

​Runs

GET /runs

GET /runs/{id}

​OpenAPI Specification

​Error Handling

​Rate Limits

API Reference

Overview

Base URL

Authentication

Endpoints

Health

MCP Gateway

Receipts

Runs

OpenAPI Specification

Error Handling

Rate Limits