mcpField
D
dfmi x402 market

dfmi x402 market

Local
dfmi.appFinance0Updated 6d ago
RepositoryVisit website

About dfmi x402 market

dfmi x402 market is an MCP server for browsing and purchasing services in the dfmi x402 agent market. It lets agents inspect listings and quotes, claim dUSD points, and buy services under code-enforced spending limits.

Key features

  1. 01Browse ranked service listings
  2. 02Request prices without signing
  3. 03View wallet balance and limits
  4. 04Create a throwaway buyer wallet
  5. 05Claim free dUSD points
  6. 06Purchase with capped spending

Use cases

  1. 01Compare listed services and prices
  2. 02Check an endpoint price before buying
  3. 03Claim dUSD points for a purchase
  4. 04Buy a service within configured limits

MCP support

The server exposes market browsing, quoting, wallet, faucet, and purchase tools to MCP clients such as Claude, Cursor, and Codex.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "dfmi-app-dfmi-market": {
      "command": "npx",
      "args": [
        "-y",
        "dfmi-market-mcp"
      ],
      "env": {
        "DFMI_BUYER_PRIVATE_KEY": "<DFMI_BUYER_PRIVATE_KEY>",
        "DFMI_MAX_PRICE": "<DFMI_MAX_PRICE>",
        "DFMI_SESSION_BUDGET": "<DFMI_SESSION_BUDGET>",
        "DFMI_ALLOW_MAINNET": "<DFMI_ALLOW_MAINNET>"
      }
    }
  }
}
Run commandnpx -y dfmi-market-mcp
Environment variables to set
DFMI_BUYER_PRIVATE_KEYSecretOptional throwaway buyer key. If unset, dfmi_create_wallet makes one in ~/.dfmi.
DFMI_MAX_PRICEHard cap per purchase (default 0.10).
DFMI_SESSION_BUDGETTotal spend cap per server run (default 1.00).
DFMI_ALLOW_MAINNETSet to 1 to allow mainnet payments. Off by default.

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npmdfmi-market-mcp0.1.1

Tools

6

Saved tool list · updated 2w ago

ParameterTypeRequiredDescription
querystringNoOptional keyword filter, e.g. "report" or "summarize"

Details

From the project README

dfmi-market-mcp

MCP server for the dfmi x402 agent market. Plug it into Claude, Cursor, Codex or any MCP client and the agent can browse services, get quotes, claim free dUSD points and buy — with hard spend limits enforced in code.

ToolWhat it doesPays?
dfmi_list_servicesRanked catalog from bazaar.dfmi.app (price, score, unique buyers)no
dfmi_quoteAsk any x402 endpoint for its price, without signingno
dfmi_walletBuyer address, dUSD balance, limits leftno
dfmi_create_walletCreate a throwaway buyer wallet in ~/.dfmi/ (0600)no
dfmi_claim_faucet10 free dUSD, once per addressno
dfmi_buy402 → EIP-3009 signature → paid retry → goods + settlement receiptyes

Install

Claude Code:

claude mcp add dfmi -- npx -y dfmi-market-mcp

Claude Desktop / Cursor (mcpServers):

{ "dfmi": { "command": "npx", "args": ["-y", "dfmi-market-mcp"] } }

Then ask: "Find a market report on dfmi, check the price, and buy it."

Limits (code, not prompt)

EnvDefaultMeaning
DFMI_MAX_PRICE0.10Max per purchase. The model may lower it per call, never raise it.
DFMI_SESSION_BUDGET1.00Total spend for one server run.
DFMI_ALLOW_MAINNEToffOnly dfmi dUSD points and Base Sepolia test USDC unless set to 1.
DFMI_BUYER_PRIVATE_KEY—Use your own throwaway key instead of ~/.dfmi/buyer-wallet.json.

dUSD is a points unit with no monetary value: claim it free from the faucet or buy it with a card on dfmi.app; it cannot be refunded or cashed out. Use a throwaway wallet only.

Develop

npm install
npm test

Publish (operator)

  1. Move this folder into dfmi-app/dfmi-app as market-mcp/ (matches server.json → repository.subfolder).
  2. npm publish (package name dfmi-market-mcp was free on 2026-10-15; mcpName in package.json must match server.json name).
  3. Publish to the official MCP Registry: mcp-publisher login github (as the dfmi-app org), then mcp-publisher publish.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.