Skip to content
whiteknightonhorsePublic

About

One MCP + REST endpoint to APIbase's live tool catalog (counts: https://apibase.pro/llms.txt), plus Integrator: an MCP storefront for any shop, paid by AI agents straight to the merchant wallet. No signup, no subscription, no API key to start — pay per call in USDC (x402 on Base or MPP on Tempo).

Topics

Resources

Security policy

Stars

10 stars

Watchers

0 watching

Forks

Latest commit

 

History

2,251 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

APIbase.pro — The API Hub for AI Agents

One MCP + REST endpoint to 1381 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.


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 · ERC-8004 agent #399542 (8004scan)


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

About

One MCP + REST endpoint to APIbase's live tool catalog (counts: https://apibase.pro/llms.txt), plus Integrator: an MCP storefront for any shop, paid by AI agents straight to the merchant wallet. No signup, no subscription, no API key to start — pay per call in USDC (x402 on Base or MPP on Tempo).

Topics

Resources

Security policy

Stars

10 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages