Skip to main content

​
TypeScript Integration

An official TypeScript SDK is on the roadmap. For now, use the REST API directly with fetch(). The examples below show you how.
Which endpoint? ASG exposes two protocols:
  • REST (/v1/mcp/tools/call) — recommended for quickstart and most integrations. See Python SDK for REST examples.
  • JSON-RPC (/mcp) — for MCP-native agent frameworks. The examples on this page use JSON-RPC since TypeScript is the primary MCP SDK language.
Both require the same Authorization: Bearer <api_key> header.

​
Quick Start

const ASG_ENDPOINT = 'https://agent.asgcompute.com/mcp';
const API_KEY = process.env.ASG_API_KEY!;

// Step 1: Call a tool (will return 402 with quote)
async function callTool(name: string, args: Record<string, unknown>) {
  const response = await fetch(ASG_ENDPOINT, {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'Authorization': `Bearer ${API_KEY}`
    },
    body: JSON.stringify({
      jsonrpc: '2.0',
      id: 1,
      method: 'tools/call',
      params: { name, arguments: args }
    })
  });

  if (response.status === 402) {
    const quote = await response.json();
    // quote.payment_instructions has pay_to, usdc_mint, network
    // Build and submit Solana USDC transfer, then retry:
    return quote;
  }

  return response.json();
}

// Step 2: Retry with payment proof
async function callToolWithPayment(
  name: string,
  args: Record<string, unknown>,
  paymentProof: string  // base64url-encoded JSON
) {
  const response = await fetch(ASG_ENDPOINT, {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'Authorization': `Bearer ${API_KEY}`,
      'X-Payment': paymentProof
    },
    body: JSON.stringify({
      jsonrpc: '2.0',
      id: 1,
      method: 'tools/call',
      params: { name, arguments: args }
    })
  });

  return response.json();
}

​
List Available Tools

async function listTools() {
  const response = await fetch(ASG_ENDPOINT, {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'Authorization': `Bearer ${API_KEY}`
    },
    body: JSON.stringify({
      jsonrpc: '2.0',
      id: 1,
      method: 'tools/list'
    })
  });

  const data = await response.json();
  return data.result.tools;
  // [{ name: 'inference_chat', description: '...' }, ...]
}

​
Inference Example

// Get a quote for inference
const quote = await callTool('inference_chat', {
  model: 'openai/gpt-4o-mini',
  messages: [{ role: 'user', content: 'Hello!' }]
});

console.log(`Price: ${quote.quote.price_display}`);
// "Price: $0.0024"

// After paying on Solana, retry with X-Payment header
const result = await callToolWithPayment(
  'inference_chat',
  {
    model: 'openai/gpt-4o-mini',
    messages: [{ role: 'user', content: 'Hello!' }]
  },
  paymentProof
);

console.log(result.result.content);

​
Error Handling

async function reliableCall(name: string, args: Record<string, unknown>, maxRetries = 3) {
  for (let attempt = 0; attempt < maxRetries; attempt++) {
    try {
      const response = await fetch(ASG_ENDPOINT, {
        method: 'POST',
        headers: {
          'Content-Type': 'application/json',
          'Authorization': `Bearer ${API_KEY}`
        },
        body: JSON.stringify({
          jsonrpc: '2.0', id: 1,
          method: 'tools/call',
          params: { name, arguments: args }
        })
      });

      const data = await response.json();

      if (data.error?.code === 'QUOTE_EXPIRED') {
        continue; // Retry with fresh quote
      }
      if (data.error?.code === 'RATE_LIMITED') {
        await new Promise(r => setTimeout(r, 1000 * (attempt + 1)));
        continue;
      }

      return data;
    } catch (err) {
      if (attempt === maxRetries - 1) throw err;
    }
  }
  throw new Error('Max retries exceeded');
}

​
Payment Proof Format

The X-Payment header contains a base64url-encoded JSON object: 
const paymentProof = btoa(JSON.stringify({
  tx_signature: '5Uj3...',  // Solana transaction signature
  quote_id: 'qt_xyz789'     // Quote ID from 402 response
}));

​
Next Steps

Examples

More working examples

API Reference

Complete API documentation