# 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: 502 across 21 categories

## What We Do
APIbase aggregates 502 API tools from 158+ 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 502 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 502 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 502 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)
Token: USDC on Base mainnet
Prices: $0.001–$0.035 per call (tool-dependent)
Details: https://apibase.pro/.well-known/x402-payment.json

## 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