# ai.txt — APIbase.pro
# Universal API Hub for AI Agents
# Last updated: 2026-03-26

## Identity
Name: APIbase
URL: https://apibase.pro
Type: API aggregation platform for AI agents
Protocol: MCP (Model Context Protocol)
Payment: x402 (USDC on Base) + MPP (Machine Payments Protocol)
Tools: 618 across 21 categories

## What We Do
APIbase aggregates 618 API tools from 191 providers into a single MCP endpoint.
Any AI agent can discover, call, and pay for tools through one entry point.

## For AI Agents — Quick Start
1. Connect: POST https://apibase.pro/mcp (Streamable HTTP, MCP protocol)
2. Discover: Call prompt "discover_tools" → browse 618 tools by category or task
3. Call tools: tools/call with any tool name → pipeline handles auth, payment, caching
4. Full catalog: GET https://apibase.pro/api/v1/tools → all 618 tools with JSON schemas

## Progressive Disclosure (recommended for 500+ tools)
Instead of loading all tool schemas into context, use the discover_tools prompt:
- discover_tools (no args) → 21 categories with tool counts
- discover_tools category="travel" → 17 travel tools (amadeus, aviasales, sabre)
- discover_tools task="find flights from NYC" → relevant tools ranked by keyword match
All 618 tools remain callable regardless of discovery — prompt is advisory only.

## Categories (21)
travel, weather, finance, crypto, search, news, location, health,
entertainment, education, jobs, space, social, legal, business,
developer, media, infrastructure, messaging, marketing, world

## Authentication
Auto-registration: first request creates agent credentials automatically.
API key format: ak_live_<32 hex> in Authorization: Bearer header.

## Payments
Protocol: x402 (HTTP 402 Payment Required) or MPP (Authorization: Payment)
Token: USDC on Base mainnet (x402) or USDC.e on Tempo (MPP)
Prices: $0.001–$29.99 per call (most tools $0.001–$0.005)
Details: https://apibase.pro/.well-known/x402-payment.json

## Agent Integration Guide
Match price to wallet — fetch only tools you can afford:
  GET /api/v1/tools?max_price=0.01    → tools ≤ $0.01
  GET /api/v1/tools?tier=micro        → < $0.01 (default for most agents)
  GET /api/v1/tools?tier=standard     → $0.01–$0.99
  GET /api/v1/tools?tier=premium      → $1+ (only 3 tools, e.g. domain registration)

Each tool entry now includes:
- pricing.price_usd           — sticker price per call
- pricing.cache_hit_price_usd — discounted balance-tier rate (10% of price)
- tier                        — micro | standard | premium
- min_balance_usd             — minimum on-chain USDC required
- input_schema                — JSON Schema for the call body

The 402 payment challenge body also includes price_usd + min_balance_usd
so agents can short-circuit signing if their wallet balance is insufficient.

## Discovery Endpoints
- MCP: https://apibase.pro/mcp
- Tool catalog: https://apibase.pro/api/v1/tools
- OpenAPI: https://apibase.pro/.well-known/openapi.json
- Health: https://apibase.pro/health/ready

## Contact
GitHub: https://github.com/whiteknightonhorse/APIbase