aegrid-sdk

TypeScript SDK for Aegrid — build AI agents that can shop products and discover 11,000+ AI services.

Install

npm install aegrid-sdk

Quick Start

import { AegridClient } from 'aegrid-sdk';

const aegrid = new AegridClient({ apiKey: 'your_key' });

// Search 11,000+ AI services
const results = await aegrid.search({ q: 'image generation', pricing: 'free' });
console.log(results.data);

// Get a specific service
const service = await aegrid.getService('service_id');

// Route an API call through the Aegrid gateway (auto-finds best healthy service)
const result = await aegrid.executeApi({
  capability: 'inference',
  payload: { prompt: 'Hello' },
  fallback: true,
});

// Initiate a purchase (returns approval link for human confirmation)
const order = await aegrid.execute({
  task: 'Buy running shoes size 10',
  buyer_context: {
    name: 'Sarah Johnson',
    email: '[email protected]',
    shipping_address: {
      line1: '123 Main St',
      city: 'Austin',
      state: 'TX',
      zip: '78701',
      country: 'US',
    },
  },
});
console.log(order.approval_url); // Human must click to approve

API

Search & Discovery

| Method | Description | |--------|-------------| | search(params) | Search 11,000+ AI services by keyword, capability, pricing, platform | | getService(id) | Get details for a specific service | | getStats() | Get catalog stats (total services, online count, breakdown by platform) |

Commerce

| Method | Description | |--------|-------------| | execute(params) | One-call agent purchase — finds a product, creates an order, returns approval link | | executeApi(params) | Route an API call through the Aegrid gateway with automatic fallback |

Registration

| Method | Description | |--------|-------------| | registerService(params) | Register a new AI service in the catalog |

Utility

| Method | Description | |--------|-------------| | health() | Health check |

Configuration

const aegrid = new AegridClient({
  apiKey: 'your_aegrid_api_key',        // Required for write operations
  baseUrl: 'https://api.aegrid.ai',     // Default; override for self-hosted
  fetch: customFetch,                    // Optional custom fetch implementation
});

Get an API Key

Sign up at aegrid.ai/register — free tier available.

Also Available

• aegrid-mcp — MCP server for Claude Desktop, Claude Code, and Cursor
• @aegrid/types — Shared TypeScript types

License

MIT