![\"Dexter\"](\"https://raw.githubusercontent.com/Dexter-DAO/dexter-x402-sdk/main/assets/dexter-wordmark.svg\")
\n\n \n
\n x402 gateway for AI agents. Search, pay, and call any paid API.\n
\n\n\n ![\"npm\"](\"https://img.shields.io/npm/v/@dexterai/mcp.svg\")
\n ![\"Node\"](\"https://img.shields.io/badge/node-%3E=18-brightgreen.svg\"){kind=icon}
\n ![\"Marketplace\"](\"https://img.shields.io/badge/Marketplace-dexter.cash-blueviolet\"){kind=icon}
\n Browse paid APIs →\n
\n\n---\n\n## What is x402?\n\n[x402](https://x402.org) 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, processing millions of settlements.\n\n---\n\n## Install\n\n```bash\nnpx @dexterai/mcp install\n```\n\nSupports **Cursor**, **Claude Code**, **Codex**, **VS Code**, **Windsurf**, and **Gemini CLI**.\n\nThe installer creates a local Solana wallet at `~/.dexterai-mcp/wallet.json` and writes the MCP config for your client. Fund the wallet with USDC and your agent can start paying for APIs.\n\n### Manual Configuration\n\n**Cursor** — `~/.cursor/mcp.json`:\n\n```json\n{\n \"mcpServers\": {\n \"dexter-x402\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"@dexterai/mcp@latest\"]\n }\n }\n}\n```\n\n**Claude Code:**\n\n```bash\nclaude mcp add dexter-x402 -- npx -y @dexterai/mcp@latest\n```\n\n**Codex** — `~/.codex/config.toml`:\n\n```toml\n[mcp_servers.dexter-x402]\ncommand = \"npx\"\nargs = [\"-y\", \"@dexterai/mcp@latest\"]\n```\n\n---\n\n## Tools\n\n### `x402_search`\n\nSearch the [Dexter Marketplace](https://dexter.cash/opendexter) for paid API resources. Returns pricing, quality scores, verification status, seller reputation, and call volume.\n\n```\n\"Find image generation APIs under $0.10\"\n→ x402_search(query: \"image generation\", maxPriceUsdc: 0.10)\n\n\"What DeFi tools are available on Solana?\"\n→ x402_search(category: \"DeFi\", network: \"solana\")\n```\n\n| Param | Type | Description |\n|-------|------|-------------|\n| `query` | string | Search term |\n| `category` | string | `\"AI\"`, `\"DeFi\"`, `\"Data\"`, `\"Tools\"`, `\"Games\"`, `\"Creative\"` |\n| `network` | string | `\"solana\"`, `\"base\"`, `\"polygon\"` |\n| `maxPriceUsdc` | number | Maximum price per call |\n| `verifiedOnly` | boolean | Only quality-checked endpoints |\n| `sort` | string | `\"relevance\"` `\"quality_score\"` `\"settlements\"` `\"volume\"` `\"recent\"` |\n| `limit` | number | 1–50, default 20 |\n\n---\n\n### `x402_fetch`\n\nCall any x402-protected API with automatic payment. The MCP detects the 402 response, signs a USDC payment with your local wallet, and retries the request — returning the API response directly.\n\nWorks with any x402 seller, not just Dexter endpoints:\n\n```\n\"Get a Jupiter DEX quote for 1 SOL to USDC\"\n→ x402_fetch(\"https://x402.dexter.cash/api/jupiter/quote?inputMint=So11...&amount=1000000000\")\n→ Pays $0.05, returns the full quote with route plan\n\n\"Generate an image of a robot trading crypto\"\n→ x402_fetch(\"https://api.xona-agent.com/image-model/seedream-4.5\", method: \"POST\", body: '{\"prompt\":\"a robot trading crypto\"}')\n→ Pays $0.08 to Xona Agent, returns the image URL\n```\n\n| Param | Type | Description |\n|-------|------|-------------|\n| `url` | string | The x402 resource URL |\n| `method` | string | `GET` `POST` `PUT` `DELETE` — default `GET` |\n| `body` | string | JSON request body for POST/PUT |\n\nResponse includes the API data plus on-chain settlement proof:\n\n```json\n{\n \"status\": 200,\n \"data\": { \"...API response...\" },\n \"payment\": {\n \"settled\": true,\n \"details\": {\n \"transaction\": \"Djo6aA9SXFx...\",\n \"network\": \"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp\",\n \"payer\": \"2SB3VTnjrct...\"\n }\n }\n}\n```\n\n---\n\n### `x402_check`\n\nProbe an endpoint to see its pricing and payment options without spending anything. Returns the full 402 requirements including price per chain, accepted assets, and input/output schemas when available.\n\n```\n\"How much does this API cost?\"\n→ x402_check(\"https://x402.dexter.cash/api/v2-test\", method: \"POST\")\n→ $0.01 USDC on Solana, $0.01 USDC on Base\n```\n\n| Param | Type | Description |\n|-------|------|-------------|\n| `url` | string | The URL to check |\n| `method` | string | `GET` `POST` `PUT` `DELETE` — default `GET` |\n\n---\n\n### `x402_wallet`\n\nShow the wallet address, SOL and USDC balances, and the wallet file location. If the wallet has no USDC, returns deposit instructions.\n\n```json\n{\n \"address\": \"2SB3VTnjrct9ayYCsQ4Fi5C5vNVpwL8X8RYUQoaPNZGh\",\n \"network\": \"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp\",\n \"balances\": { \"sol\": 0.001, \"usdc\": 0.94 },\n \"walletFile\": \"~/.dexterai-mcp/wallet.json\"\n}\n```\n\n---\n\n## CLI\n\nEvery tool is also available as a standalone command:\n\n```bash\nnpx @dexterai/mcp wallet\nnpx @dexterai/mcp search \"token analysis\"\nnpx @dexterai/mcp fetch \"https://x402.dexter.cash/api/v2-test\" --method POST\n```\n\n---\n\n## Wallet\n\nA standard Solana keypair stored at `~/.dexterai-mcp/wallet.json` with `600` permissions. The private key never leaves your machine.\n\nOverride with an environment variable:\n\n```bash\nexport DEXTER_PRIVATE_KEY=\"your-base58-private-key\"\n```\n\n`SOLANA_PRIVATE_KEY` is also accepted. The env var takes priority over the wallet file.\n\n---\n\n## Supported Chains\n\n| Chain | Network ID | Gas Token |\n|-------|------------|-----------|\n| Solana | `solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp` | SOL |\n| Base | `eip155:8453` | ETH |\n| Polygon | `eip155:137` | POL |\n| Arbitrum | `eip155:42161` | ETH |\n| Optimism | `eip155:10` | ETH |\n| Avalanche | `eip155:43114` | AVAX |\n| SKALE Europa | `eip155:2046399126` | sFUEL (free) |\n\nThe MCP auto-detects which chain a 402 response requires and signs with the appropriate method. Powered by [`@dexterai/x402`](https://www.npmjs.com/package/@dexterai/x402).\n\n---\n\n## Links\n\n- [Dexter Marketplace](https://dexter.cash/opendexter)\n- [Dexter Facilitator](https://x402.dexter.cash)\n- [@dexterai/x402 SDK](https://www.npmjs.com/package/@dexterai/x402)\n- [x402 Protocol](https://x402.org)\n- [Twitter](https://twitter.com/dexteraisol)\n- [Telegram](https://t.me/dexterdao)\n- [Become a Seller](https://dexter.cash/onboard)\n\n## License\n\nMIT\n","readmeFilename":"README.md"}