Agent Quickstart

Get your headless agent calling ASG tools. Time to first call: ~2 minutes.

Start free: Use get_status and echo to validate your setup before making paid calls. These tools are always free — no payment required.

Prerequisites

ASG API key (create in Console)
For paid tools: Solana wallet with USDC (mainnet)

Step 1: Create API Key

Open Console
Connect wallet → API Keys → Create Key
Copy key (starts with sk-agent-...)

export ASG_API_KEY="sk-agent-YOUR_KEY_HERE"

Step 2: Verify Setup (Free)

Test connectivity and auth with the free get_status tool — no payment needed:

curl -X POST https://agent.asgcompute.com/v1/mcp/tools/call \
  -H "Authorization: Bearer $ASG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "tool": "get_status",
    "params": {}
  }'

import requests, os

ASG = "https://agent.asgcompute.com/v1/mcp/tools/call"
API_KEY = os.environ["ASG_API_KEY"]

r = requests.post(ASG, json={
    "tool": "get_status",
    "params": {}
}, headers={
    "Authorization": f"Bearer {API_KEY}",
    "Content-Type": "application/json"
})
print(r.json())

const ASG = 'https://agent.asgcompute.com/v1/mcp/tools/call';
const API_KEY = process.env.ASG_API_KEY!;

const res = await fetch(ASG, {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({ tool: 'get_status', params: {} }),
});
console.log(await res.json());

Expected response (200):

{
  "ok": true,
  "result": {
    "version": "v5.2.3",
    "status": "healthy",
    "balance_usdc": "11.11"
  }
}

✅ If you see "ok": true, your API key works. Move to the next step.

Step 3: Echo Test (Free)

Validate payload format with the free echo tool — no payment needed:

curl -X POST https://agent.asgcompute.com/v1/mcp/tools/call \
  -H "Authorization: Bearer $ASG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "tool": "echo",
    "params": {
      "message": "hello from my agent"
    }
  }'

import requests, os

ASG = "https://agent.asgcompute.com/v1/mcp/tools/call"
API_KEY = os.environ["ASG_API_KEY"]

r = requests.post(ASG, json={
    "tool": "echo",
    "params": {"message": "hello from my agent"}
}, headers={
    "Authorization": f"Bearer {API_KEY}",
    "Content-Type": "application/json"
})
print(r.json())

const ASG = 'https://agent.asgcompute.com/v1/mcp/tools/call';
const API_KEY = process.env.ASG_API_KEY!;

const res = await fetch(ASG, {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    tool: 'echo',
    params: { message: 'hello from my agent' },
  }),
});
console.log(await res.json());

Expected response (200):

{
  "ok": true,
  "result": {
    "echo": "hello from my agent"
  }
}

✅ If your message is echoed back, your request format is correct.

Step 4: Discover Available Tools

List all tools and their billing status:

curl -s https://agent.asgcompute.com/mcp/capabilities \
  | jq '.tools[] | {name, status, billable}'

import requests

r = requests.get("https://agent.asgcompute.com/mcp/capabilities")
for tool in r.json().get("tools", []):
    print(f"{tool['name']:30} billable={tool.get('billable', 'N/A')}")

const res = await fetch('https://agent.asgcompute.com/mcp/capabilities');
const data = await res.json();
for (const tool of data.tools) {
  console.log(`${tool.name.padEnd(30)} billable=${tool.billable}`);
}

Step 5: Make a Paid Call

Call a billable tool. If you have pre-funded balance, this returns 200 with the result immediately. If no balance, you get 402 with a quote.

curl -X POST https://agent.asgcompute.com/v1/mcp/tools/call \
  -H "Authorization: Bearer $ASG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "tool": "inference_chat",
    "params": {
      "model": "openai/gpt-4o-mini",
      "messages": [{"role":"user","content":"Hello!"}]
    }
  }'

import requests, os

ASG = "https://agent.asgcompute.com/v1/mcp/tools/call"
API_KEY = os.environ["ASG_API_KEY"]

r = requests.post(ASG, json={
    "tool": "inference_chat",
    "params": {
        "model": "openai/gpt-4o-mini",
        "messages": [{"role": "user", "content": "Hello!"}]
    }
}, headers={
    "Authorization": f"Bearer {API_KEY}",
    "Content-Type": "application/json"
})
data = r.json()
# 402 → data["quote"]["quote_id"], data["step_id"]
# 200 → data["result"]["content"]  (if balance-funded)
print(r.status_code, data)

const ASG = 'https://agent.asgcompute.com/v1/mcp/tools/call';
const API_KEY = process.env.ASG_API_KEY!;

const res = await fetch(ASG, {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    tool: 'inference_chat',
    params: {
      model: 'openai/gpt-4o-mini',
      messages: [{ role: 'user', content: 'Hello!' }],
    },
  }),
});
const data = await res.json();
// 402 → data.quote.quote_id, data.step_id
// 200 → data.result.content  (if balance-funded)
console.log(res.status, data);

If 200 — Success! The result is in data.result.content. If 402 — Payment Required:

{
  "code": "PAYMENT_REQUIRED",
  "quote": {
    "quote_id": "abc123",
    "amount_usdc_microusd": 10000
  },
  "payment_instructions": {
    "network": "solana-mainnet",
    "pay_to": "<treasury_ata>",
    "usdc_mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"
  },
  "step_id": "step_xyz"
}

Step 6: Pay and Retry

Send USDC on-chain, then retry with proof:

curl -X POST https://agent.asgcompute.com/v1/mcp/tools/call \
  -H "Authorization: Bearer $ASG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "tool": "inference_chat",
    "params": {
      "model": "openai/gpt-4o-mini",
      "messages": [{"role":"user","content":"Hello!"}]
    },
    "idempotency_key": "550e8400-e29b-41d4-a716-446655440000",
    "payment_proof": {
      "tx_ref": "<solana_tx_signature>",
      "amount_usdc": "0.010000",
      "memo": "<step_id>:<quote_id>:1",
      "quote_id": "<quote_id>",
      "step_id": "<step_id>",
      "network": "solana-mainnet"
    }
  }'

import requests, os

ASG = "https://agent.asgcompute.com/v1/mcp/tools/call"
API_KEY = os.environ["ASG_API_KEY"]

r = requests.post(ASG, json={
    "tool": "inference_chat",
    "params": {
        "model": "openai/gpt-4o-mini",
        "messages": [{"role": "user", "content": "Hello!"}]
    },
    "idempotency_key": "550e8400-e29b-41d4-a716-446655440000",
    "payment_proof": {
        "tx_ref": "<solana_tx_signature>",
        "amount_usdc": "0.010000",
        "memo": "<step_id>:<quote_id>:1",
        "quote_id": "<quote_id>",
        "step_id": "<step_id>",
        "network": "solana-mainnet"
    }
}, headers={
    "Authorization": f"Bearer {API_KEY}",
    "Content-Type": "application/json"
})
print(r.json())

const ASG = 'https://agent.asgcompute.com/v1/mcp/tools/call';
const API_KEY = process.env.ASG_API_KEY!;

const res = await fetch(ASG, {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    tool: 'inference_chat',
    params: {
      model: 'openai/gpt-4o-mini',
      messages: [{ role: 'user', content: 'Hello!' }],
    },
    idempotency_key: '550e8400-e29b-41d4-a716-446655440000',
    payment_proof: {
      tx_ref: '<solana_tx_signature>',
      amount_usdc: '0.010000',
      memo: '<step_id>:<quote_id>:1',
      quote_id: '<quote_id>',
      step_id: '<step_id>',
      network: 'solana-mainnet',
    },
  }),
});
console.log(await res.json());

Faster path: Deposit USDC via Console → Balance first. Then paid tool calls deduct from your balance automatically — no per-call on-chain transactions needed.

Available Tools

Tool	Status	Billable	Notes
`get_status`	✅ Active	Free	System status + balance
`echo`	✅ Active	Free	Validate auth + payload
`inference_chat`	✅ Active	Paid	GPT-4o, Claude, Gemini
`optify_vram_estimate`	✅ Active	Paid	GPU memory estimation
`sandbox_execute`	✅ Active	Paid	Python/JS code execution
`sandbox_cancel`	✅ Active	Free	Cancel running sandbox
`gpu_provision`	🔜 Coming Soon	—	GPU provisioning

See Tool Availability for the full catalog.

MCP Integration

For agents using the Model Context Protocol, connect directly:

{
  "mcpServers": {
    "asg": {
      "url": "https://agent.asgcompute.com/mcp",
      "transport": "streamable-http",
      "headers": {
        "Authorization": "Bearer sk-agent-YOUR_KEY"
      }
    }
  }
}

Works with Claude Desktop, Cursor, Windsurf, and any MCP-compatible client.

Error Codes

Status	Code	Meaning
200	—	Success
401	`UNAUTHORIZED`	Invalid or missing API key
402	`PAYMENT_REQUIRED`	Deposit or pay to continue
403	`FORBIDDEN`	Scope not authorized
429	`RATE_LIMITED`	Too many requests
500	—	Server error (retry with idempotency key)

What’s Next?

SDK Examples

TypeScript and Python code examples

Payment Flow

Complete payment lifecycle guide

Pricing

Service pricing details

Architecture

How ASG works under the hood

Getting Started

Services

Billing

SDK

Security

Resources

Agent Quickstart

Agent Quickstart

Prerequisites

Step 1: Create API Key

Step 2: Verify Setup (Free)

Step 3: Echo Test (Free)

Step 4: Discover Available Tools

Step 5: Make a Paid Call

Step 6: Pay and Retry

Available Tools

MCP Integration

Error Codes

What’s Next?

SDK Examples

Payment Flow

Pricing

Architecture

​Agent Quickstart

​Prerequisites

​Step 1: Create API Key

​Step 2: Verify Setup (Free)

​Step 3: Echo Test (Free)

​Step 4: Discover Available Tools

​Step 5: Make a Paid Call

​Step 6: Pay and Retry

​Available Tools

​MCP Integration

​Error Codes

​What’s Next?

SDK Examples

Payment Flow

Pricing

Architecture

Agent Quickstart

Prerequisites

Step 1: Create API Key

Step 2: Verify Setup (Free)

Step 3: Echo Test (Free)

Step 4: Discover Available Tools

Step 5: Make a Paid Call

Step 6: Pay and Retry

Available Tools

MCP Integration

Error Codes

What’s Next?