Foundry: prepaid AI compute in USDF

Connect it to your AI

Claude Code

claude mcp add --transport http gateway https://api.usdf.fi/mcp

Claude, ChatGPT, Cursor and other apps

Add it as a custom connector with this URL (Streamable HTTP):

https://api.usdf.fi/mcp

This server expects extra headers, usually an API key from its maker.

Cursor, VS Code and other apps (mcp.json)

{
  "mcpServers": {
    "gateway": {
      "url": "https://api.usdf.fi/mcp"
    }
  }
}

Tools it offers

10 tools, as the server itself reported during our check on Oct 31, 2026.

• list_modelsModels the gateway serves with their context window, output limits and whether a route is available right now; with an API key, their prices too (USD per 1M tokens, the same figure in USDF).
• quoteThe hold the chat tool places before running a request, in USDF and USD (output capped at 4096 tokens). It is an estimate, not a ceiling: a completed request is billed the provider's reported usage, normally less. Pass p
• list_toolsTools you can call through POST /v1/tools/{id}, paid from the same balance and key as chat, each with the input it takes (with an API key, its price in USDF too), ordered by title. Every tool listed can be called now. q
• quote_toolWhat a call to a tool would hold for this input before it runs (its most it can cost), in USDF and USD, with the tool's price. It checks the input as the call would, and runs and holds nothing. No key needed.
• x402_payCalls a URL that asks for an x402 payment and pays it for you: the gateway pays the seller in USDC from its own float and charges this key in USDF the seller's amount and the payer's fee (never free credit), within the k
• agents_market_searchAgents, APIs and tools priced per call, in one market, every listing in the same shape: its id (svc_...), name, description, tags, site and logo, how it is called (GET or POST), what one call costs in USDF from this key'
• agents_market_callCalls a listing of the agents market by its id (svc_..., from agents_market_search), paid from this key's USDF balance (never free credit) within the key's and its agent's limits and at most max_price: what one call cost
• chatRuns a chat completion and returns the text with its receipt (tokens, price, cost, balance, settlement). With an API key it spends from that key's balance, holding the most the request can cost first. Not streamed. Outpu
• balanceWith an API key: what the key can spend now, the account's balance and the amount held for requests running, and what is left of the key's budget, in USDF. With address instead, and no key: that wallet's USDF and USDG on
• receiptWith the API key that made the request: its receipt, with the usage, the price sheet version, the cost and, once settled, the settlement, its transaction and the rows behind the onchain digest. With no key: the public re

Questions