Skip to main content

API Overview

ASG Agent Cloud uses the Model Context Protocol (MCP) for all tool interactions.

Endpoints

ASG exposes two endpoints — use whichever matches your integration:
EndpointProtocolUse case
/v1/mcp/tools/callREST (recommended)Quickstart, most integrations
/mcpJSON-RPC 2.0MCP-native agent frameworks
Base URL:
https://agent.asgcompute.com

Protocol

All requests use JSON-RPC 2.0 over HTTP POST.

Request Format

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "tool_name",
    "arguments": { ... },
    "_meta": {
      "payment": {
        "tx_signature": "optional-payment-proof"
      }
    }
  }
}

Methods

MethodDescription
tools/listList available tools
tools/callExecute a tool

Authentication

All requests require an API key via Bearer token:
Authorization: Bearer <api_key>
Create API keys in the Console. See Authentication for details.

Response Format

Success (200)

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": "...",
    "_meta": {
      "receipt_id": "rcpt_abc123",
      "debited_usdc_microusd": 10000
    }
  }
}

Payment Required (402)

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": 402,
    "message": "Payment Required",
    "data": {
      "quote_id": "quote_xyz",
      "amount_usdc_microusd": 10000,
      "expires_at": "2026-02-01T12:01:00Z"
    }
  }
}

Active Tools

ToolDescriptionBillableStatus
inference_chatAI completions with 100+ modelsYes✅ Available
optify_vram_estimateEstimate VRAM requirementsYes✅ Available
sandbox_executeExecute code in isolationYes✅ Available
sandbox_cancelCancel running sandboxNo✅ Available
get_statusSystem status + balanceNo✅ Available
echoValidate auth + connectivityNo✅ Available
See Tool Availability for the full catalog and roadmap.

Rate Limits

TierRequests/minRequests/day
Default6010,000
EnterpriseCustomCustom

Next Steps

Error Codes

Full error code reference

SDK

Use our TypeScript SDK