Skip to main content

​
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 a Solana wallet signature: 
Authorization: Bearer <wallet-signature>

​
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:

​
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

TierRequests/minBurst
Default6010
EnterpriseCustomCustom
Rate limit headers are included in responses:
  • X-RateLimit-Limit
  • X-RateLimit-Remaining
  • X-RateLimit-Reset