# ai.txt — APIbase.pro
# Universal API Hub for AI Agents

## 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: 1405 across 25 categories

## What We Do
APIbase aggregates 1405 tools from 405 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 1405 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 1405 tools with JSON schemas

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

## Categories (25)
business, crypto, developer, device, education, entertainment, finance, health,
infrastructure, jobs, legal, location, logistics, marketing, media, messaging, music,
news, podcasts, search, social, space, travel, weather, 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.0005–$29.99 per call (90% of tools <= $0.003)
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=<usd>   → tools priced at or below <usd>
  GET /api/v1/tools?tier=micro        → micro-priced tools

Each tool entry includes:
- pricing.price_usd           — sticker price per call
- pricing.cache_hit_price_usd — discounted balance-tier rate
- tier                        — price tier of the tool
- 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
X: https://x.com/apibase_pro