AI Tools API for Developers & Agents

Query 5,000+ AI tool profiles from a free MCP server, or a REST API metered per request in USDC. No API keys, no accounts, no subscriptions.

View Endpoints Connect via MCP

How the REST API Works

Only if you need REST. Over MCP everything is free and none of this applies.

Step 1

Request

Your agent sends a standard HTTP request to any endpoint

Step 2

Pay

x402 middleware returns 402 — your agent pays $0.001+ USDC automatically

Step 3

Get Data

Full structured JSON with pricing, features, ratings, and more

No API keys. No accounts. No subscriptions. The x402 protocol handles payment natively over HTTP using USDC on Base.

Endpoints

Base URL: https://x402.aigregator.com

GET/v1/tools/:slug

Full tool profile — name, pricing plans, features, pros/cons, ratings, alternatives

$0.001

GET/v1/compare

Compare 2-5 tools side-by-side — pricing, features, pros/cons matrix

$0.01

POST/v1/advisor

Describe a need in plain language, get a ranked shortlist with a reason per pick. Answers in about 2 seconds

$0.05

GET/v1/search

Discover tool slugs by keyword, category, pricing type, or free plan. Returns {slug, name} only — use /v1/tools/:slug for full details

Free

GET/v1/categories

List all 18 categories in the directory. /v1/tags and /v1/categories/:slug/tools are free too

Free

View raw API

Quick Start

curl

# Request tool data
curl https://x402.aigregator.com/v1/tools/chatgpt

# Response: 402 Payment Required
# The x402 client library handles payment automatically.
# Your agent pays $0.001 USDC on Base, then gets the data.

TypeScript (x402 client)

import { wrapFetchWithPayment } from "@x402/fetch";
import { x402Client } from "@x402/core/client";
import { ExactEvmScheme } from "@x402/evm/exact/client";
import { privateKeyToAccount } from "viem/accounts";

// Set up x402 client with your wallet
const signer = privateKeyToAccount(process.env.EVM_KEY);
const client = new x402Client();
client.register("eip155:*", new ExactEvmScheme(signer));

// Wrap fetch — payments happen automatically
const fetchWithPay = wrapFetchWithPayment(fetch, client);

// Query Aigregator — $0.001 per request
const res = await fetchWithPay(
  "https://x402.aigregator.com/v1/tools/chatgpt"
);
const tool = await res.json();
console.log(tool.name, tool.pricing);

MCP Server

Connect Claude, Cursor or any MCP client straight to Aigregator. Your assistant can search, compare and recommend tools natively.

Every MCP tool is free. No API key, no account, no wallet — including the tools the REST API charges for. The prices further down apply only to REST, for clients that cannot speak MCP.

Claude Code — one command

claude mcp add --transport http aigregator https://x402.aigregator.com/mcp

Or configure manually

{
  "mcpServers": {
    "aigregator": {
      "type": "http",
      "url": "https://x402.aigregator.com/mcp"
    }
  }
}

Streamable HTTP with SSE fallback, negotiated automatically. Add this to your Claude Desktop or Cursor MCP settings.

list_categoriesBrowse all 18 AI tool categoriesFree

search_toolsDiscover slugs by keyword — returns {slug, name} onlyFree

get_toolGet full profile for any toolFree

compare_toolsCompare 2-5 tools side-by-sideFree

recommend_toolsDescribe a need, get a ranked shortlistFree

Skill & reference on GitHub

The API reference, the OpenAPI 3.1 spec and a Claude Code skill live in one public repository. The skill teaches a coding agent when to reach for Aigregator, not just how to call it.

Install the skill

claude plugin marketplace add Aigregator/skills

Then /plugin install aigregator. Or without Claude Code: npx skills add Aigregator/skills.

api.md

The full contract — MCP tools, REST endpoints, errors

openapi.yaml

OpenAPI 3.1, for generated clients and tooling

skills/aigregator

The Claude Code skill

github.com/Aigregator/skills

REST pricing

These prices apply to the REST API only — the MCP server above is free. Pay only for what you use, no minimum and no monthly fee. Powered by x402 micropayments in USDC on Base.

Endpoint	Price
Tool Lookup`/v1/tools/:slug`	$0.001
Compare`/v1/compare`	$0.01
Advisor`/v1/advisor`	$0.05
Search`/v1/search`	Free
Categories`/v1/categories`	Free
Tags`/v1/tags`	Free
Category Tools`/v1/categories/:slug/tools`	Free

Free endpoints return minimal data ({slug, name} only for search and category listings) — use paid endpoints for full profiles. Settlement on Base (gas < $0.0001).

Ready to integrate?

Start querying 5,000+ AI tool profiles in minutes. No signup required.

API Documentation MCP Discovery