@dexterai/opendexter

@dexterai/opendexter is the local npm package for the OpenDexter discovery and payment flow.

Use it when you want the OpenDexter tool surface in a local stdio runtime rather than in a hosted connector.

What It Is

OpenDexter exists in more than one form:

• hosted public MCP at open.dexter.cash/mcp
• authenticated Dexter MCP profiles
• local npm package
• OpenClaw plugin via @dexterai/clawdexter

This page is about the local npm package specifically.

Current Package Name

The current public npm package is @dexterai/opendexter.

One important source-accuracy note:

• npm metadata confirms @dexterai/opendexter exists
• some older or internal repo documentation may still mention @dexterai/x402-discovery

For public docs, treat @dexterai/opendexter as the canonical install name.

When To Use It

Use @dexterai/opendexter when:

• you want a local stdio setup
• you are using Cursor, Codex, Claude Code, or another local CLI/editor agent runtime
• you want a persistent local signer instead of a hosted session wallet
• you want the OpenDexter five-tool discovery and payment flow without OpenClaw

Use hosted OpenDexter instead when:

• the environment cannot install a package
• you want session wallets managed by the hosted flow
• you are using hosted agent environments like ChatGPT or Claude connectors

Use @dexterai/clawdexter instead when:

• your runtime is OpenClaw specifically
• you want the OpenClaw plugin path instead of a generic local stdio path

Install

The published package README documents this install path:

npx @dexterai/opendexter install

The package README explicitly says it supports:

• Cursor
• Claude Code
• Codex
• VS Code
• Windsurf
• Gemini CLI

The installer is documented as doing two things:

1. creating a local Solana wallet at ~/.dexterai-mcp/wallet.json
2. writing MCP configuration for the selected client

Manual Configuration

The package README also documents manual setup examples.

Cursor

~/.cursor/mcp.json

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

Claude Code

claude mcp add dexter-x402 -- npx -y @dexterai/opendexter@latest

Codex

~/.codex/config.toml

[mcp_servers.dexter-x402]
command = "npx"
args = ["-y", "@dexterai/opendexter@latest"]

Runtime Model

This package is documented in source and in this docs repo as:

• transport: local stdio
• wallet model: persistent local signer
• best for: Cursor, Codex, CLI agents, and local development environments

The installer and package README describe the signer location as:

• ~/.dexterai-mcp/wallet.json

The package README also documents environment override support:

export DEXTER_PRIVATE_KEY="your-base58-private-key"

SOLANA_PRIVATE_KEY is also accepted, and the environment variable takes priority over the wallet file.

Tool Surface

The package README and local-tool docs align on the same five-tool flow:

• x402_search
• x402_check
• x402_wallet
• x402_fetch
• x402_pay

What each tool does

Search parameters documented by the package README

The package README documents x402_search with support for:

• search the marketplace

and these filters:

• query
• category
• network
• maxPriceUsdc
• verifiedOnly
• sort
• limit

Fetch behavior documented by the package README

The package README documents x402_fetch as:

• detecting 402 Payment Required
• signing a USDC payment with the local wallet
• retrying the request automatically
• returning API data plus settlement proof

CLI surface

The package README also exposes standalone CLI entrypoints like:

npx @dexterai/opendexter wallet
npx @dexterai/opendexter search "token analysis"
npx @dexterai/opendexter fetch "https://x402.dexter.cash/api/v2-test" --method POST

How It Differs From Hosted OpenDexter

The docs in this repo consistently describe the local package as the same OpenDexter tool story with a different wallet and transport model.

How It Differs From @dexterai/clawdexter

If you are not specifically targeting OpenClaw, @dexterai/opendexter is the better conceptual default.

Supported Chains

The package README explicitly documents support for:

• Solana
• Base
• Polygon
• Arbitrum
• Optimism
• Avalanche
• SKALE Base

It also documents that the package auto-detects which chain a 402 response requires and signs with the appropriate method.

Common Failure Modes

Product/package confusion

OpenDexter the product is not the same thing as @dexterai/opendexter the package.

This page documents the package.

Wrong runtime choice

If the user cannot install a local package, they likely need the hosted OpenDexter MCP instead.

Wallet file confusion

The local package is documented around a persistent wallet file at ~/.dexterai-mcp/wallet.json. If the user expects hosted session wallets, they are using the wrong runtime.

Expecting OpenClaw-specific behavior

If the target runtime is OpenClaw, use @dexterai/clawdexter, not the generic local package docs.

Naming drift

If you see @dexterai/x402-discovery in older/internal material, do not assume it is the public npm package. Public docs should prefer @dexterai/opendexter.

Funding the wrong thing

The local package expects the user to fund their own local wallet, not a hosted session address.

Related Pages

• OpenDexter Tools
• Access Modes
• x402 Tools
• Clawdexter
• Paying for Resources