# whiteknightonhorse/APIbase [Health: Active]

**Category:** 🔗 Aggregators  
**Repository:** https://github.com/whiteknightonhorse/APIbase  
**GitHub Stars:** 10  
**npm Downloads (last month):** 10189  
**Views:** 3  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/whiteknightonhorse-apibase

## Description
Unified API hub for AI agents with 56+ tools across travel (Amadeus, Sabre), prediction markets (Polymarket), crypto, and weather. Pay-per-call via x402 micropayments in USDC.

## Tools
Capabilities this server exposes over MCP:

- **fetch** — HTTP fetch with automatic authentication and payment handling. Makes the request, retries with SIGN-IN-WITH-X when the route exposes a SIWX challenge, and only pays if the route still returns 402. Returns response data and the final response headers, including raw payment receipt proof when supplied by the server, along with payment details (price, tx hash) if a payment was made.

For endpoints you haven't called before in this session, you MUST call check_endpoint_schema first to confirm the request body schema. Skipping this causes 400 errors from wrong field names.
- **get_balance** — Get your total USDC balance across all supported networks. Auto-creates the wallet on first use (~/.agentcash/wallet.json). Use this before paid API calls to confirm you have funds available.
- **list_accounts** — List wallet accounts for each supported network. Returns the network, address, balance, and deposit link for every supported network so you can see where to fund the wallet. Auto-creates the wallet on first use (~/.agentcash/wallet.json). If onboardingCta is present, show its message to the user — it means they haven't onboarded yet and need to either visit the onboard link or deposit directly.
- **check_endpoint_schema** — Get the input/output schema and auth mode (paid or SIWX) for a single endpoint.

Call this to see exactly what fields the request body expects and what the response contains.

Returns the schema from the origin's OpenAPI spec. Optionally pass sample_input_body to probe the endpoint live (without payment) for an exact price quote — do this when pricing is dynamic (range-based or variable), or when you're unsure about the input schema. Treat auth mode as advisory: fetch handles both SIWX and paid routes.
- **redeem_invite** — Redeem an invite code for free USDC on Base. One-time use per code. Returns amount received and transaction hash. Use get_balance after to verify funds, or list_accounts if you need the per-network deposit links as well.
- **discover_api_endpoints** — List available endpoints at an API origin. Returns endpoint URLs with descriptions of what each does and the auth mode for each (paid or SIWX). Works with any origin, not just the registered ones.

Call this when you need to see what routes are available at an origin — whether it's one of the registered origins or any other origin you've identified as useful. Treat the auth mode as guidance for what the route may require; fetch handles both SIWX and payment.

The response always indicates whether guidance is available. Guidance is documentation published by the API provider explaining how endpoints work together, edge cases, and usage tips. compact guidance is included automatically; set include_guidance=true to force-include full usage documentation when you need to compose two or more endpoints or need clarification on how the origin works.
- **report_error** — EMERGENCY ONLY. Report critical MCP tool bugs. Do NOT use for normal errors (balance, network, 4xx) — those are recoverable.
- **update_settings** — Update user settings (persisted to ~/.agentcash/settings.json). Currently supports maxAmount — the maximum USD amount allowed per fetch request. If a fetch response requests more than this, the payment is rejected. Returns the current settings after applying changes.
- **get_settings** — Get current user settings. Returns persisted values from ~/.agentcash/settings.json with defaults applied.
- **bridge** — Bridge USDC between supported networks using the current wallet. Requires a source network, destination network, and amount. Use this when funds are on one supported network and the user needs them moved to another. Bridging is subject to fees.
- **search** — Search for relevant paid API services by describing what you need in natural language. Returns the best matching origins with endpoint details and pricing. The top result includes the full input/output schema so you can call it immediately via fetch.

Only use this when you DON'T already know which registered origin to use. If the task clearly maps to a registered origin (e.g. people search → StableEnrich, image generation → StableStudio), skip search and go straight to discover_api_endpoints on that origin. Search is for discovering NEW or UNKNOWN capabilities outside the registered origins.

Set broad=true to widen the search to include newer, unvetted tools that may not have established trust. Use this if the default results don't cover what you need.
- **sessions_close** — Close an MPP `tempo:session` payment channel. Pass the channelId surfaced in a prior fetch's paymentInfo together with the same URL you originally fetched. Signs a close credential with the on-chain settled cumulative amount and POSTs it to the server, returning the on-chain settlement transaction hash when available. Use this when you want to finalize a channel rather than leaving it open for the server to settle on its own schedule.

## Claude Desktop Quick Installation
Remote MCP endpoint (confidence: high). Install path detected from listing signals. Add as a URL/SSE server in your client:

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

## Documentation

## What whiteknightonhorse/APIbase MCP server does

whiteknightonhorse/APIbase MCP server presents a unified MCP interface for calling external API services. Its documented catalog covers 1,378 tools from 395 providers, while the supplied tool list describes the control layer used to discover endpoints, inspect schemas, execute requests, and manage payments. Example API areas mentioned in the listing include travel, prediction markets, crypto, and weather.

The central `fetch` tool sends HTTP requests with authentication and payment handling. It can retry a request after a SIGN-IN-WITH-X challenge and pays only when the route continues to return HTTP 402. Results include response data and final headers; when available, payment information includes the price, transaction hash, and raw receipt proof.

## How it works

Before calling an endpoint for the first time in a session, use `check_endpoint_schema`. It returns the origin's input and output schema plus its stated authentication mode. A sample request body can optionally be used to probe an endpoint without payment and obtain a price quote, which is useful for variable or range-based pricing.

`discover_api_endpoints` lists routes available from an API origin, including descriptions and payment or SIWX guidance. `search` finds relevant paid services when the required origin is unknown; it should not replace direct discovery when a known registered origin already matches the task. The `fetch` tool handles both SIWX and paid routes regardless of the advisory auth mode.

Payments use USDC. The wallet is created automatically at `~/.agentcash/wallet.json` when balance or account tools are first used. `get_balance` reports the combined balance across supported networks, while `list_accounts` provides per-network addresses, balances, and deposit links. `bridge` moves USDC between supported networks, and `sessions_close` finalizes an MPP payment channel when given the channel ID and original URL.

## Setup and configuration

The hosted configuration is an MCP URL:

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

The README lists compatibility guidance for Claude Desktop, Cursor, Windsurf, OpenAI Agents SDK, LangChain, Google ADK, CrewAI, and Microsoft Copilot Studio. Self-hosting uses Docker Compose after cloning the repository, copying `.env.example` to `.env`, and setting `POSTGRES_PASSWORD`, `X402_PAYMENT_ADDRESS`, and provider keys. The documented production stack uses PostgreSQL, Redis, and a Node.js/TypeScript API server.

## Tools and capabilities

- Inspect endpoint schemas and optional live price quotes.
- Discover routes and search for unfamiliar paid API services.
- Execute HTTP requests with SIWX and x402 payment handling.
- View, fund, and bridge wallet balances across supported networks.
- Set a maximum USD amount allowed for each fetch request.
- Redeem invite codes for free USDC on Base.
- Close MPP payment channels and retrieve settlement information.

## Limitations and notes

Payment calls require available USDC, and bridging can incur fees. `report_error` is intended only for critical MCP tool bugs, not ordinary balance, network, or HTTP 4xx errors. Endpoint auth guidance is advisory because `fetch` handles both SIWX and paid routes. For unfamiliar endpoints, skipping schema inspection can lead to HTTP 400 errors caused by incorrect field names. whiteknightonhorse/APIbase MCP server also persists wallet and settings data locally when using the documented default paths.

_Full upstream README: https://allmcps.com/mcp/whiteknightonhorse-apibase/readme_