Skip to content

whiteknightonhorse/APIbase

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

144 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

APIbase.pro — The API Hub for AI Agents

One MCP endpoint. 227 tools. 58 providers. Pay per call with x402 USDC on Base.

Live Platform | Tool Catalog | MCP Endpoint | Health | Dashboard

APIbase MCP server

What is APIbase?

Production MCP server that gives AI agents access to 227 real-world API tools through a single endpoint. Agents connect once to https://apibase.pro/mcp and can search flights, get stock quotes, translate text, check weather alerts, generate images, send emails, look up holidays, shorten URLs, detect fires by satellite — and 200+ more tools across 20+ categories.

Built for AI agents, not humans. Auto-registration, zero setup, pay-per-call via x402 USDC micropayments on Base.


Quick Start (30 seconds)

Claude Desktop / Cursor / Windsurf

{
  "mcpServers": {
    "apibase": {
      "url": "https://apibase.pro/mcp"
    }
  }
}

Via npm (stdio bridge)

{
  "mcpServers": {
    "apibase": {
      "command": "npx",
      "args": ["-y", "apibase-mcp-client"]
    }
  }
}

REST API

# Register and get API key
curl -X POST https://apibase.pro/api/v1/agents/register \
  -H "Content-Type: application/json" \
  -d '{"agent_name": "my-agent", "agent_version": "1.0.0"}'

# Call any tool
curl -X POST https://apibase.pro/api/v1/tools/finnhub.quote/call \
  -H "Authorization: Bearer ak_live_..." \
  -H "Content-Type: application/json" \
  -d '{"symbol": "AAPL"}'

Tool Categories (227 tools, 58 providers)

Category Tools Providers Examples
Web Search 9 Serper, Tavily, Exa Google search, AI search, semantic search
News & Events 7 NewsData, GDELT, Mastodon Global news (65 langs), crypto news, trending
Travel & Flights 17 Amadeus, Sabre, Aviasales Flight search, pricing, status, airports
Finance & Stocks 16 Finnhub, CoinGecko, ECB, FRED Stock quotes, OHLCV, FX rates, economic data
Currency Conversion 2 ExchangeRate-API 160+ currencies, real-time conversion
Maps & Geo 7 Geoapify Geocode, routing, POI search, isochrone
Real Estate 4 Walk Score, US Real Estate Walkability, property listings, details
Entertainment 24 TMDB, Ticketmaster, RAWG, IGDB, Jikan Movies, events, games, anime
Music 7 MusicBrainz, ListenBrainz, RadioBrowser Artists, albums, radio stations
Health & Nutrition 7 USDA, OpenFDA, NIH Food data, drug safety, supplements
Education & Research 7 OpenAlex, arXiv, PubMed, CrossRef Papers, colleges, DOI lookup
Jobs & Career 6 BLS, ESCO, CareerJet Salary data, occupations, job listings
Legal & Regulatory 8 Regulations.gov, Federal Register, CourtListener US regulations, court opinions, executive orders
Weather & Earth 3 NWS, NASA FIRMS US weather alerts, satellite fire detection
Space & Astronomy 9 NASA, JPL APOD, asteroids, fireballs, solar flares
Translation 3 Langbly 90+ languages, language detection
Sports 4 API-Sports Football (2000+ leagues), basketball (NBA)
Holidays & Calendar 3 Nager.Date, Calendarific 230+ countries, national/religious/observance
Image Generation 1 Stability AI Stable Diffusion, 16 style presets
OCR 1 OCR.space Text from images/PDFs, 20+ languages
Email & SMS 4 Resend, Twilio Send emails, SMS, phone lookup
URL Shortener 2 Short.io Custom branded short links + stats
SSL & Domain 5 WhoisXML, ssl-checker.io WHOIS, DNS, SSL cert check
Barcode & QR 4 QRServer, UPCitemdb Generate/read QR, barcode lookup
E-commerce 8 Zinc, Diffbot Product search, web extraction
AI Marketing 7 AIPush AI-optimized pages, visibility scores
World Clock 3 TimeAPI.io Timezone conversion, 597 IANA zones
Screenshots 1 ApiFlash Chrome-based URL capture
Earthquakes 3 USGS Global seismic data, real-time feeds
IP Intelligence 2 ipapi.is Geolocation, VPN/proxy detection
Crypto & DeFi 26 CoinGecko, Polymarket, Hyperliquid Prices, prediction markets, perpetuals

Full tool catalog with schemas: https://apibase.pro/api/v1/tools


How Payment Works

Field Value
Protocol x402 (HTTP 402 Payment Required)
Token USDC on Base
Wallet 0x50EbDa9dA5dC19c302Ca059d7B9E06e264936480
Price range $0.001 – $1.00 per call

No subscriptions. No minimums. Agent pays only for successful calls. Failed provider calls are auto-refunded.

13-Stage Pipeline

Every tool call passes through:

AUTH → IDEMPOTENCY → CONTENT_NEG → SCHEMA_VALIDATION → TOOL_STATUS →
CACHE → RATE_LIMIT → ESCROW → PROVIDER_CALL →
ESCROW_FINALIZE → LEDGER_WRITE → CACHE_SET → RESPONSE
  • Escrow-first: USDC locked before provider call, refunded on failure
  • Idempotent: same request + same key = same result, no double charges
  • Cache: per-tool TTL (5s for stock prices, 7 days for walkability scores)
  • Fail-closed: Redis down = reject all, no silent degradation

Authentication

Method Header Format
API Key Authorization Bearer ak_live_<32hex>
x402 Payment X-Payment Base64 payment receipt

Auto-registration: agents get API keys instantly on first request. No forms, no approval.


Error Codes

HTTP Code Meaning
400 validation_error Invalid parameters (check schema)
401 unauthorized Missing or invalid API key
402 payment_required x402 payment needed
404 not_found Tool or resource not found
429 rate_limited Rate limit exceeded (check Retry-After)
502 bad_gateway Provider unavailable
503 service_unavailable System not ready

MCP Discovery

GET /.well-known/mcp.json → MCP server metadata
GET /api/v1/tools → Full tool catalog with schemas (all 227 in one response)
GET /health/ready → System health check

Integrations

Platform Config
Claude Desktop "url": "https://apibase.pro/mcp"
Cursor "url": "https://apibase.pro/mcp"
Windsurf "serverUrl": "https://apibase.pro/mcp"
VS Code Copilot "type": "http", "url": "https://apibase.pro/mcp"
Continue.dev Streamable HTTP: https://apibase.pro/mcp
OpenAI GPT Import https://apibase.pro/.well-known/openapi.json
Smithery smithery.ai/servers/apibase-pro/api-hub
Glama glama.ai/mcp/servers/whiteknightonhorse/APIbase
MCP Registry io.github.whiteknightonhorse/apibase

Architecture

  • 16 Docker containers: API, Worker, Outbox, PostgreSQL, Redis, Nginx, Prometheus, Grafana, Loki, Promtail, Alertmanager, exporters
  • Single Hetzner server with automated health checks, graceful shutdown, and 27 Prometheus alert rules
  • PostgreSQL = source of truth for financial data (append-only ledger)
  • Redis = cache, rate limiting, single-flight deduplication
  • Fail-closed: any infrastructure failure = reject requests, never pass through

Self-Hosting

git clone https://github.com/whiteknightonhorse/APIbase.git
cp .env.example .env    # configure secrets
docker compose -f docker-compose.yml -f docker-compose.prod.yml up -d

License

MIT

About

Universal MCP gateway for AI agents — 227 tools, 58 providers. Flights, stocks, news, search, maps, sports, translation, legal, OCR, image gen, email, SMS. Pay per call with x402 USDC on Base.

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors