JarvisClaw — AI Gateway & API Marketplace

io.github.api-jarvisclawPublished by GitHub account api-jarvisclawv1.1.0Updated Oct 24, 2026

320 AI models + 2,720 pay-per-call APIs. x402 USDC on Base or Solana, no API key.

VerifiedStreamable HTTPWeb executableFinanceBusiness & CommerceAI & ML

Overview

AI-generated overview

JarvisClaw is an AI gateway and pay-per-call API marketplace that lets an assistant chat with many models, search and call priced APIs, and run budget-capped AI

What you can do
List and chat with AI models through one OpenAI-compatible endpoint, with automatic routing to a suitable model when no ID is given. Search the API marketplace and read the full spec, pricing and request format for a chosen endpoint. Discover other registered agents by capability, category or name. Browse AIP intent types, estimate a task's cost, and resolve ranked, priced providers for an intent. Execute an AI task end to end under a spending cap you set, with settlement in USDC on Base or Solana.
When to use it
Use it when you want one connection to many frontier models and thousands of individually priced APIs, or when you want an assistant to plan and run paid AI tasks with a hard budget limit and no account or API key.
Requirements
Either a remote Streamable HTTP endpoint or the local npm package run with npx (Node.js). Paid tools need a wallet private key in JARVISCLAW_WALLET_KEY for local signing, or a pre-paid API key sent as an Authorization Bearer header on the remote path. JARVISCLAW_CHAIN selects base or solana; a custom Solana RPC can be set. Free catalogue tools need no credential.
Before you install
Paid tools spend real USDC from the wallet whose key is supplied; the key is used for local signing and should be treated as sensitive. The remote path cannot sign payments, so paid tools there need a pre-paid key. A safety cap rejects single payments above 100 USDC. The README notes unresolved moderate npm advisories via the Solana library, loaded even on the Base path.

Installation

In SourceWeft

  1. Open JarvisClaw — AI Gateway & API Marketplace in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.api-jarvisclaw%2Fjarvisclaw/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "jarvisclaw-ai-gateway-api-marketplace": {
      "type": "http",
      "url": "https://api.jarvisclaw.ai/mcp"
    }
  }
}

README

JarvisClaw MCP Server

283 AI models and 2,720 pay-per-call APIs through one MCP server. Settles in USDC on Base or Solana over x402 — no account, no API key, no subscription.

Three ways to reach a service:

  • Models — 283 of them (GPT-5, Claude Opus 5, Gemini 3, DeepSeek) behind one OpenAI-compatible chat tool, or auto to let the router pick.
  • API marketplace — 2,720 individually priced endpoints across 40 categories (search, blockchain, code, DNS, image, document, OCR, email, geo, TTS…), of which 411 are curated. Search it, read the price, then call it.
  • AIP intents — 13 intent types. Say what you need (web_search, image_generation, translation…) and AIP resolves it to a provider, so the caller never has to know the URL layout.

Counts move as the catalogue changes; list_models, search_apis and aip_list_intents are the live answer.

Quick start

Local wallet signing (recommended for x402)

Run this package. It presents itself to your client as a normal stdio MCP server, forwards every request to the gateway, and when a call needs paying it signs the x402 payment on your machine and retries. Your private key is never transmitted — only the signed payment payload is.

bash
JARVISCLAW_WALLET_KEY=0xyourkey npx jarvisclaw-mcp

Claude Desktop / Cursor, Base wallet:

json
{  "mcpServers": {    "jarvisclaw": {      "command": "npx",      "args": ["-y", "jarvisclaw-mcp"],      "env": {        "JARVISCLAW_WALLET_KEY": "0xYOUR_BASE_PRIVATE_KEY",        "JARVISCLAW_CHAIN": "base"      }    }  }}

Solana wallet:

json
{  "mcpServers": {    "jarvisclaw": {      "command": "npx",      "args": ["-y", "jarvisclaw-mcp"],      "env": {        "JARVISCLAW_WALLET_KEY": "YOUR_SOLANA_BS58_SECRET_KEY",        "JARVISCLAW_CHAIN": "solana"      }    }  }}

Direct URL (no local process)

For Claude Code, Cursor, or any client with Streamable HTTP transport. One less hop, but there is no wallet in this path: free tools work, and paid tools need a pre-paid API key, because nothing here can sign a payment.

json
{  "mcpServers": {    "jarvisclaw": {      "type": "url",      "url": "https://api.jarvisclaw.ai/mcp",      "headers": { "Authorization": "Bearer sk-your-api-key" }    }  }}

Without the header the same URL still lists the catalogue for free; paid tools answer with an x402 quote that you would have to sign yourself.

Environment variables

VariableRequiredDefaultDescription
JARVISCLAW_WALLET_KEYfor paid tools—Base private key (0x… hex) or Solana secret key (base58). Used only for local signing.
JARVISCLAW_CHAINnobasebase or solana. Which option to sign when the server offers both.
JARVISCLAW_MCP_URLnohttps://api.jarvisclaw.ai/mcpRemote MCP endpoint.
JARVISCLAW_SOLANA_RPCnopublic mainnet RPCCustom Solana RPC (recommended — the public one is rate-limited).
JARVISCLAW_API_KEYno—Optional API key sent as Authorization: Bearer. Free tools need no credential.

Tools

ToolWhat it doesBilled
list_modelsEvery model available, with the IDs to pass to chatfree
search_apisSearch the 2,720-endpoint marketplace; each hit carries its path and pricefree
aip_list_intentsBrowse the intent types AIP can routefree
aip_estimate_costPrice an intent before committing to itfree
chatAny model, OpenAI-compatiblepaid
get_api_detailFull spec for a marketplace API: pricing, method, exact requestpaid
discover_agentsFind other agents registered on the gatewaypaid
aip_resolveRank providers for an intent, priced, before you spendpaid
aip_execute_with_budgetRun a task end to end under a spending cap you setpaid

Free tools answer without credentials, so you can list the catalogue before deciding to pay for anything. Protocol methods (initialize, tools/list, resources/list) are free too.

Paying

MethodHeaderWhen
x402 USDCPAYMENT-SIGNATURENo account. Wallet settles on Base or Solana.
API keyAuthorization: Bearer sk-…Pre-paid account.

A paid tool called without either does not fail — it answers with an x402 quote:

tools/call → 402 with payment terms (amount, asset, payTo, network)          → this proxy signs a USDC authorization locally          → retry with PAYMENT-SIGNATURE → result

With JARVISCLAW_WALLET_KEY set, all three steps happen inside this process and your client just sees the result. Without it, the quote is passed through to your client unanswered.

Both chains are live, which most x402 sellers cannot say: settle wherever the agent already holds USDC rather than bridging to reach one gateway. Every paid response carries an EIP-712 signed settlement receipt that a third party can verify offline — recompute the hashes, recover the signer, check the tx on-chain — without trusting us.

Security

  • The wallet key is read from the environment and used only to sign payment authorizations locally. It is never sent to the gateway or anywhere else.
  • A safety cap rejects any single payment above 100 USDC, on both chains.
  • The USDC contract address, mint, chain IDs and decimals are pinned as protocol constants, not configuration — a server cannot talk this proxy into signing a transfer of some other asset.

Dependency advisories

npm audit reports 3 moderate advisories reachable through @solana/web3.js (itself, plus jayson and uuid). 1.98.4 is the latest release and is inside the flagged range, so there is no version to move to; npm's suggested "fix" is a downgrade to 0.0.3, which is not a real option. Tracked, not resolved.

This applies to Base-only users too: @solana/web3.js is a static import in the entry module, so it loads whatever JARVISCLAW_CHAIN is set to (measured: 6 module resolutions on the Base path). Only the signer object is constructed lazily.

Building from source

bash
npm installnpm run build     # tsc → dist/npm test          # bun test — x402 signer unit tests

Links

License

MIT

Source: README.md at commit d2690f5

Tools

9

list_models

List every AI model available on JarvisClaw — GPT, Claude, Gemini, DeepSeek, and more — with the model IDs you plug straight into the chat tool. Free, and the fastest way to see what you can call.

Takes no parameters.

chat

Send a chat completion to any model on JarvisClaw through one OpenAI-compatible endpoint — GPT, Claude, Gemini, DeepSeek, and more. Pass a specific model ID or use 'auto' for smart routing to the best fit. One tool, every frontier model, no per-provider setup.

Parametersmodelrequiredmessagesrequiredmax_tokenstemperature

search_apis

Search every API on JarvisClaw — thousands of callable endpoints across search, blockchain, image, data, document and more, plus APIs other developers have published. Returns the exact invocation path and per-call price for each result, so you can call one directly afterwards. Free to search; you only pay when you invoke.

Parametersquerycategory

get_api_detail

Get the full spec for any API returned by search_apis — pricing, method, and the exact request to send. Works for both a user-published API slug and a catalogue handle like 'federation/40'. Use this before wiring a call in.

Parametersslugrequired

discover_agents

Find other AI agents registered on JarvisClaw and connect to them directly. Search by capability, category, or name to get each agent's MCP URL and API endpoints — so your agent can delegate, collaborate, or chain work with others in the network.

Parameterstagssearchcategory

aip_resolve

Find the best AI provider for a task and get ranked, priced options before you commit a cent. Pass a known intent type (chat_completion, code_execution, code_generation, data_analysis, document_processing, image_generation, knowledge_search, prompt_optimization, text_to_speech, translation, utility, video_generation, web_search) for structured routing, or a plain-language query for semantic matching. Each match returns provider, model, live per-request price, and a ready-to-call endpoint. Free to call — no payment until you execute.

Parametersintentrequiredfeaturesoptimize_formax_price_usd

aip_execute_with_budget

Run an AI task end-to-end with a hard spending cap you set. This is the primary AIP action: it resolves the best provider, runs a risk check, pre-deducts against your budget, executes the call, and settles on-chain via x402 — all in one step. You never overspend past max_total_usd, and settlement is automatic. Supports chat, image, video, speech, prompt optimization, web search, and knowledge search intents.

Parametersintentrequiredpayloadrequiredmax_total_usdpreferred_payment

aip_list_intents

Browse every AI task type AIP can route — chat, image, video, speech, web search, knowledge search — with a short description of each. Call this first to see what's on the menu before you resolve or execute. Free.

Takes no parameters.

aip_estimate_cost

Preview what a task will cost before committing — get an estimated price for an intent without running it or spending anything. Ideal for budget planning and comparing options up front. Free.

Parametersintentrequiredoptimize_for

Version history

1
  1. v1.1.0LatestSep 16, 2026

Score

90% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

    Declare a license in the repository or the registry entry.