opendexter

<p align="center"> <img src="https://raw.githubusercontent.com/Dexter-DAO/dexter-x402-sdk/main/assets/dexter-wordmark.svg" alt="Dexter" width="360"> </p>

<h1 align="center">OpenDexter</h1>

<p align="center"> <strong>x402 payments for AI agents — search, pay, and build with paid APIs.</strong><br> Skills, rules, tools, and an MCP server for Claude Code, Cursor, and any MCP client. </p>

<p align="center"> <a href="https://x402.org"><img src="https://img.shields.io/badge/protocol-x402_v2-00FF88" alt="x402"></a> <a href="https://www.npmjs.com/package/@dexterai/opendexter"><img src="https://img.shields.io/npm/v/@dexterai/opendexter.svg" alt="npm"></a> <a href="https://www.npmjs.com/package/@dexterai/x402"><img src="https://img.shields.io/npm/v/@dexterai/x402.svg?label=%40dexterai%2Fx402" alt="SDK"></a> <a href="https://dexter.cash/opendexter"><img src="https://img.shields.io/badge/Marketplace-5%2C000%2B_APIs-blueviolet" alt="Marketplace"></a> <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="MIT"></a> </p>

<p align="center"> <a href="https://dexter.cash/opendexter"><strong>Browse Marketplace</strong></a>  |   <a href="https://x402.org"><strong>x402 Protocol</strong></a>  |   <a href="https://www.npmjs.com/package/@dexterai/x402"><strong>SDK Docs</strong></a> </p>

---

Install

There are two ways to run OpenDexter. Hosted is the fastest: nothing to install, and the wallet is a session you fund with a QR code. Local runs the MCP server on your machine with a self-custodied wallet key.

Hosted (no install)

Add the hosted MCP server to any MCP client's config. There is nothing to download; you pair and fund a session wallet at dexter.cash.

{
  "mcpServers": {
    "opendexter": {
      "url": "https://open.dexter.cash/mcp"
    }
  }
}

That is the whole setup. Skip to Fund your wallet.

Local (self-custody)

Runs @dexterai/opendexter on your machine; the wallet key lives in ~/.dexterai-mcp/wallet.json.

Claude Code. Install the plugin (skills, rules, agent, commands, and the MCP server). Do not also add the hosted or local server by hand. The plugin already includes it.

claude plugins marketplace add Dexter-DAO/opendexter-ide
claude plugins install opendexter

Cursor

npx @dexterai/opendexter install --client cursor

Any other MCP client. The installer covers Codex, VS Code, Windsurf, and Gemini CLI:

npx @dexterai/opendexter install --client <codex|vscode|windsurf|gemini-cli>

Or add the server to your client's MCP config by hand:

{
  "mcpServers": {
    "opendexter": {
      "command": "npx",
      "args": ["-y", "@dexterai/opendexter"]
    }
  }
}

Fund your wallet

A paid call needs USDC. After install, fund whichever wallet you are using:

• Hosted: pair the session at dexter.cash and fund it with the QR code.
• Local: send USDC (Solana or Base) to the address printed during install, or run the card_issue tool to set up a Dextercard and fund calls from that.

Your agent can call x402_wallet at any time to show the address and current balance.

---

What This Plugin Does

This plugin ships with a real MCP server that gives your agent live tools for searching, paying for, and calling paid APIs. On top of that, it has deep SDK knowledge so the agent can help you build x402 payments into your own projects.

After installing, your agent can immediately:

• Search the Dexter Marketplace for any paid API (image generation, DeFi, analytics, AI, games — thousands of endpoints)
• Check what an API costs before paying
• Pay and call any x402 API with automatic USDC settlement
• Help you build x402 clients, servers, React apps, Stripe integrations, and access passes

---

What is x402?

x402 is an open protocol for machine-to-machine payments over HTTP. When an API returns 402 Payment Required, it includes payment instructions. The client pays (USDC on Solana, Base, or other chains), and the API delivers the response. No API keys, no subscriptions, no invoices.

Dexter operates the most-used x402 facilitator at https://x402.dexter.cash, processing millions of settlements across thousands of indexed endpoints from every major x402 facilitator — Dexter, Coinbase, PayAI, and more.

---

Plugin Contents

MCP Server — @dexterai/opendexter

Seven tools cover everything:

Tool	Description
x402_search	Semantic capability search over thousands of paid APIs. Returns tiered results (strong + related matches) ranked by quality, usage, and reputation.
x402_check	Preview pricing per chain without spending anything. See exactly what an API costs before committing.
x402_fetch	Call any x402 API with automatic USDC payment. Signs, pays, retries — returns the response directly with an on-chain settlement receipt.
x402_pay	Alias for x402_fetch.
x402_access	Access identity-gated endpoints with wallet proof (Sign-In-With-X).
x402_wallet	Show wallet address, USDC/SOL balances, and deposit instructions.
x402_settings	Read or update your per-call spending limit.

Two wallets are auto-created at ~/.dexterai-mcp/wallet.json on first run — one Solana, one EVM. Fund either address with USDC and your agent can start paying for APIs immediately.

---

Skills (6)

Deep knowledge the agent invokes when relevant:

Skill	What it teaches
opendexter	How to use the x402 tools: search → check → fetch workflow, quality scores, funding flows, error recovery
x402-client	Build x402 clients: wrapFetch(), createX402Client(), Budget Accounts for agents, Sponsored Access, keypair wallets, access passes
x402-server	Add x402 paywalls: x402Middleware() with multi-chain accept, Stripe PayTo, dynamic/token pricing, access passes, sponsored access injection
x402-react	React hooks: useX402Payment() (payment state, balances, tx info), useAccessPass() (tier discovery, purchase, auto-fetch)
x402-protocol	v2 spec: core types, payment flow, 3 schemes (exact, upto, bridge), HTTP/MCP/A2A transports, all CAIP-2 networks, error codes
x402-debugging	Diagnose failures: 27 SDK error codes, facilitator health, fee payer safety, retry support, pre-payment callbacks

---

Rules (2, always-on)

Injected into every conversation so the agent always knows the fundamentals:

• x402-protocol — CAIP-2 network identifiers, header conventions, atomic units, facilitator URL, supported chains
• x402-coding — Import from subpaths (@dexterai/x402/client), prefer wrapFetch() for agents, x402Middleware() for servers

---

Agent

• x402-engineer — Specialized persona that knows the full Dexter x402 stack. Validates amounts and balances before payment, never exposes private keys, reaches for x402_search whenever a user mentions paid APIs.

---

Commands (3)

Command	What it does
setup-opendexter	Install the OpenDexter MCP server into Cursor, Claude Code, Codex, VS Code, Windsurf, or Gemini CLI.
setup-x402-client	Add @dexterai/x402 to a Node.js project with wrapFetch() boilerplate and a test call.
setup-x402-server	Add x402Middleware() to an Express app with paywall configuration and test.

---

Supported Chains

Chain	Network ID (CAIP-2)	Gas Token
Solana	solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp	SOL
Base	eip155:8453	ETH
Polygon	eip155:137	POL
Arbitrum	eip155:42161	ETH
Optimism	eip155:10	ETH
Avalanche	eip155:43114	AVAX
BSC (BNB Chain)	eip155:56	BNB
SKALE Base	eip155:1187947933	sFUEL (free)

---

Links

• Dexter Marketplace — Browse thousands of paid APIs
• Dexter Facilitator — Payment infrastructure
• @dexterai/x402 SDK — Build x402 clients and servers
• @dexterai/opendexter — MCP gateway for AI agents
• x402 Protocol Spec — The open standard
• Become a Seller — List your API on the marketplace
• Twitter
• Telegram

---

License

MIT