whiteknightonhorse/APIbase

One MCP + REST endpoint to 1383 tools from 400 providers. No signup, no subscription, no API key to start — pay per call in USDC (x402 on Base or MPP on Tempo).

Security Audit Deploy License: MIT MCP Registry Smithery MPPScan

Latest release: see the tag that equals package.json version; release notes in docs/releases/.

---

Quick Start

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

That's the Claude Desktop config. Cursor, Windsurf, OpenAI Agents SDK, LangChain, Google ADK, CrewAI, Microsoft Copilot Studio, and plain REST: apibase.pro/connect.

---

For AI Agents

• llms.txt — concise LLM context
• ai.txt — plain-text agent discovery
• mcp.json — MCP server metadata
• MCP protocol versions — 2025-11-25, 2025-06-18, 2025-03-26, 2024-11-05, 2024-10-07 (Streamable HTTP on /mcp); revision 2026-07-28 is not served yet (the released SDK does not support it). Current list: protocolVersions in mcp.json
• openapi.json — OpenAPI 3.1 spec
• api-catalog — RFC 9727 discovery linkset
• Roadmap — planned/shipped changes that affect what an agent can do or see
• API providers: /partners (two ways in)

---

For Merchants — Integrator

AI payment for merchants: a merchant gets its own MCP storefront, and a buyer's agent gets a quote and pays in USDC (x402 on Base, MPP on Tempo) straight to the merchant wallet. Non-custodial; fee 0% during the pilot.

• Overview — what it is and how to connect
• Agent guide — step-by-step connection for a merchant's agent
• WooCommerce plugin — catalog sync and paid-order webhook
• Demo shop — a live storefront
• Integrator guide (source: static/integrator/docs.md); operator notes: docs/integrator.md

---

For paying agents: what protects your money

• Fixed price before payment — the 402 response states the exact amount and recipient; see payments.
• Payment identifier / idempotency — persist the id and signed payload before you send, re-send after a crash: agent guide.
• Public receipts — https://apibase.pro/r/<id>.json, see receipts. Attest one on GenLayer at https://apibase.pro/attest/?r=<id>: contract 0x1bD4C0EBC9b365905d4EBC84b944d861499afe6E on Bradbury Phase 2 (chain 4221, test network), client library genlayer-js 2.0.0-rc.2.
• Automatic refunds — for undelivered paid calls and APIbase's fee share of duplicate order payments: pricing.
• Several agents, one budget — buyers.
• Discovery order — categories, then discover, then the one tool: llms.txt, Progressive Disclosure. A bounded tool list: GET /api/tools or GET /api/v1/tools with view=compact&limit=&cursor=&category=.
• Small MCP tool list — https://apibase.pro/mcp?tools=lean lists only the discovery tools, every tool stays callable by name: llms.txt, Progressive Disclosure.
• Tool definition fingerprint — discover-tools and /api/v1/tools/manifest.

---

Integrations & Registries

Full framework guides →

Registry listings: Smithery · Glama · MCP Registry (io.github.whiteknightonhorse/apibase) · PulseMCP · MPPScan

---

Self-Hosting

git clone https://github.com/whiteknightonhorse/APIbase.git && cd APIbase
cp .env.example .env   # set POSTGRES_PASSWORD, X402_PAYMENT_ADDRESS, provider keys
docker compose -f docker-compose.yml -f docker-compose.prod.yml up -d

Full prerequisites, verification steps, and config reference: docs/self-hosting.md.

---

Architecture

Single Node.js/TypeScript API server, PostgreSQL as the append-only financial source of truth, Redis for cache/rate-limiting only, multi-container Docker stack on one Hetzner server. Every tool call runs the same multi-stage pipeline (escrow-first, idempotent, content-moderated, fail-closed on payment, cache and rate limit; the idempotency stage fails open on Redis errors) — dual-rail payments (self-hosted x402 facilitator + MPP), error-code contract, and full container/pipeline detail (exact counts, live): docs/architecture.md.

API lane

Fleet-internal: a prepaid Anthropic API credit lane overflows Fable acceptance reviews that hit a real subscription limit, through one capped wrapper. Lanes, caps, ledger, revocation and the plug-in site: docs/api-credits.md.

License

MIT