Back to Directory/Developer Tools

io.github.whiteknightonhorse/apibase

MCP endpoint to APIbase catalog (https://apibase.pro/llms.txt). USDC: x402 Base, MPP Tempo.

Developer ToolsTypeScriptv1.0.3

APIbase.pro — The API Hub for AI Agents

One MCP endpoint. 300 tools. 84 providers. Pay per call with x402 USDC on Base.

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


What is APIbase?

Production MCP server that gives AI agents access to 300 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, decode VINs, look up food products — and 200+ more tools across 30+ 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 (300 tools, 84 providers)

CategoryToolsProvidersExamples
Web Search9Serper, Tavily, ExaGoogle search, AI search, semantic search
News & Events7NewsData, GDELT, MastodonGlobal news (65 langs), crypto news, trending
Social3BlueskySearch posts, profiles, feeds (AT Protocol)
Travel & Flights17Amadeus, Sabre, AviasalesFlight search, pricing, status, airports
Finance & Stocks16Finnhub, CoinGecko, ECB, FREDStock quotes, OHLCV, FX rates, economic data
Company Data8SEC EDGAR, Companies House, GLEIFUS filings + UK registry + global LEI (200+ countries)
Currency Conversion2ExchangeRate-API160+ currencies, real-time conversion
Tax & VAT3VATcomplyEU VAT validation, rates, ECB exchange rates
Maps & Geo7GeoapifyGeocode, routing, POI search, isochrone
Address (US/CA)2GeocodioGeocode, reverse geocode, USPS-standard
Real Estate4Walk Score, US Real EstateWalkability, property listings, details
Entertainment24TMDB, Ticketmaster, RAWG, IGDB, JikanMovies, events, games, anime
Art & Culture5Europeana, ARTIC50M+ EU objects + 120K Chicago artworks
Stock Media3PexelsFree stock photos & videos, commercial use
Music7MusicBrainz, ListenBrainz, RadioBrowserArtists, albums, radio stations
Podcasts4PodcastIndexSearch 4M+ podcasts, trending, episodes
Health & Nutrition7USDA, OpenFDA, NIHFood data, drug safety, supplements
Clinical Trials3ClinicalTrials.gov577K+ trials, drug research, recruiting
Nutrition Database2FatSecret2.3M+ foods, calories, macros, vitamins
Education & Research7OpenAlex, arXiv, PubMed, CrossRefPapers, colleges, DOI lookup
Jobs & Career6BLS, ESCO, CareerJetSalary data, occupations, job listings
Legal & Regulatory8Regulations.gov, Federal Register, CourtListenerUS regulations, court opinions, executive orders
Air Quality2IQAir AirVisualAQI, pollutants (PM2.5/O3), 30K+ stations
Weather & Earth3NWS, NASA FIRMSUS weather alerts, satellite fire detection
Space & Astronomy9NASA, JPLAPOD, asteroids, fireballs, solar flares
Translation3Langbly90+ languages, language detection
Sports4API-SportsFootball (2000+ leagues), basketball (NBA)
Holidays & Calendar3Nager.Date, Calendarific230+ countries, national/religious/observance
Image Generation1Stability AIStable Diffusion, 16 style presets
OCR1OCR.spaceText from images/PDFs, 20+ languages
Speech-to-Text3AssemblyAITranscribe audio, 99 languages, diarization
PDF & Documents6API2PDF, ConvertAPIHTML/URL to PDF, DOCX↔PDF, 200+ formats
Email & SMS4Resend, TwilioSend emails, SMS, phone lookup
Messaging5TelegramSend messages, photos, documents via bot
URL Shortener2Short.ioCustom branded short links + stats
SSL & Domain5WhoisXML, ssl-checker.ioWHOIS, DNS, SSL cert check
Barcode & QR4QRServer, UPCitemdbGenerate/read QR, barcode lookup
Business Intel1Hunter.ioCompany emails, enrichment, 50M+ domains
E-commerce8Zinc, DiffbotProduct search, web extraction
AI Marketing7AIPushAI-optimized pages, visibility scores
World Clock3TimeAPI.ioTimezone conversion, 597 IANA zones
Screenshots1ApiFlashChrome-based URL capture
Domain Registration5NameSiloCheck, buy, manage domains (.com $21)
Infrastructure6CloudflareDNS management, CDN cache, traffic analytics
Browser4BrowserbaseManaged browser sessions, screenshots, scraping
Earthquakes3USGSGlobal seismic data, real-time feeds
IP Intelligence2ipapi.isGeolocation, VPN/proxy detection
Vehicle Data3NHTSA, Auto.devVIN decoder (US + global 100+ countries)
Country Data2REST CountriesCountry search, ISO code lookup
Food Products2Open Food FactsBarcode lookup, product search (3M+ products)
Test Data1RandomUser.meRandom user profiles for testing
Crypto & DeFi26CoinGecko, Polymarket, HyperliquidPrices, prediction markets, perpetuals

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


How Payment Works

FieldValue
Protocolx402 (HTTP 402 Payment Required)
TokenUSDC on Base
Wallet0x50EbDa9dA5dC19c302Ca059d7B9E06e264936480
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

MethodHeaderFormat
API KeyAuthorizationBearer ak_live_<32hex>
x402 PaymentX-PaymentBase64 payment receipt

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


Error Codes

HTTPCodeMeaning
400validation_errorInvalid parameters (check schema)
401unauthorizedMissing or invalid API key
402payment_requiredx402 payment needed
404not_foundTool or resource not found
429rate_limitedRate limit exceeded (check Retry-After)
502bad_gatewayProvider unavailable
503service_unavailableSystem not ready

MCP Discovery

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

Integrations

PlatformConfig
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.devStreamable HTTP: https://apibase.pro/mcp
OpenAI GPTImport https://apibase.pro/.well-known/openapi.json
Smitherysmithery.ai/servers/apibase-pro/api-hub
Glamaglama.ai/mcp/servers/whiteknightonhorse/APIbase
MCP Registryio.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

Installation

Source-derived launch command. Check the maintainer’s required arguments and credentials before running:

bash
npx -y apibase-mcp-client

Set up in your AI client

Merge this template into ~/Library/Application Support/Claude/claude_desktop_config.json. Keep existing servers. Add any arguments, credentials, and permissions required by the maintainer; this template has not been install-tested.

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

Restart Claude Desktop completely for changes to take effect. Confirm the server appears connected in the client’s tool list, then try a read-only example from its documentation.

Claude Desktop setup reference

Package

apibase-mcp-clientnpm

Compatible MCP Clients

io.github.whiteknightonhorse/apibase works with any MCP-compatible client. Copy the config snippet from the Configuration section above and add it to the file shown for your client, then restart the application.

  • Claude Desktop~/Library/Application Support/Claude/claude_desktop_config.jsonRestart Claude Desktop completely for changes to take effect.
  • Cursor~/.cursor/mcp.jsonRestart Cursor for changes to take effect.
  • VS Code.vscode/mcp.jsonReload VS Code window for changes to take effect.
  • Windsurf~/.codeium/windsurf/mcp_config.jsonRestart Windsurf for changes to take effect.
  • Claude Code.mcp.jsonSave at the project root, then start Claude Code in that project and review the MCP server approval prompt. Keep real credentials out of shared files.

Learn More