DYOE Trust MCP

Trust layer for AI agents: 22 pay-per-call x402 tools for scam checks, payment pre-flight, wallet screening, approvals and company research. Free preview, USDC on Base.

GitHub

Dokumentation

dyoe-trust-mcp

MCP server for DYOE, the trust layer for AI agents. It gives Claude, Cursor or any MCP client 22 pay-per-call tools from agents.dyoeway.org: scam and fraud checks, payment pre-flight, wallet screening, policy approval and human sign-off, contact extraction, company research, and data tools. Every call settles in USDC on Base via x402. You need no account or API key.

Free preview by default. Without a wallet, each tool makes one unpaid request and returns the x402 payment requirements (HTTP 402: price, network, payTo). Nothing is signed or spent.
Paid mode. Set WALLET_PRIVATE_KEY to a dedicated, low-balance Base wallet holding USDC. The key stays on your machine (stdio) and signs each payment locally. Each call is capped at DYOE_MAX_PAYMENT_USD (default 0.10). Tools priced above the cap (dyoe_review, $15) are refused until you raise it.

Install

Claude Desktop

Add this to claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/claude_desktop_config.json, Windows: %APPDATA%\Claude\claude_desktop_config.json), then restart Claude:

{
  "mcpServers": {
    "dyoe": {
      "command": "npx",
      "args": ["-y", "dyoe-trust-mcp"],
      "env": {
        "WALLET_PRIVATE_KEY": "",
        "DYOE_MAX_PAYMENT_USD": "0.10"
      }
    }
  }
}

Leave WALLET_PRIVATE_KEY empty for preview mode. The .mcpb bundle from the GitHub releases also installs with one click (Settings > Extensions).

Cursor

Add this to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (one project):

{
  "mcpServers": {
    "dyoe": {
      "command": "npx",
      "args": ["-y", "dyoe-trust-mcp"],
      "env": { "WALLET_PRIVATE_KEY": "", "DYOE_MAX_PAYMENT_USD": "0.10" }
    }
  }
}

Smithery

npx -y @smithery/cli mcp add bjyoe2016/dyoe-trust-mcp --client claude   # or --client cursor

Any MCP client

npx -y dyoe-trust-mcp          # stdio

Tools (22)

Prices are what the endpoint charges per call. The live 402 is the authority, and every result reports the price it quoted.

Tool	Price	What it does
`dyoe_verify`	$0.01	DYOE Trust Check: Check whether a website, business, or wallet is a scam before an agent trusts or pays it — fraud, phishing and rug-risk screening. Returns verdict (safe/caution/avoid), trust_score, domain age, red_flags. Input: ?target=domain
`dyoe_transaction`	$0.10	DYOE Payment Pre-Flight: Vet an entire payment before an agent sends money: is the counterparty site legit, is the payee wallet sanctioned or disposable, is the amount within policy. Returns proceed/caution/stop, reasons, and a signed attestation — one go/no-go instead of three calls. Input: ?domain=merchant.com&wallet=0x...&amount=500
`dyoe_wallet`	$0.05	DYOE Wallet Screening: Screen a crypto wallet address before an agent sends funds to it: OFAC sanctions check, on-chain footprint (empty or disposable address), human-vouch overlay. Returns verdict (safe/caution/avoid), sanctioned flag, on-chain activity, red_flags. Input: ?address=0x...
`dyoe_approve`	$0.02	DYOE Policy Authorization: Approve or deny an agent action instantly against a human-set policy — no waiting. Returns a signed decision receipt; anything over the policy line escalates to a human. Input: ?action=&counterparty=&amount= (counterparty required)
`dyoe_review`	$15.00	DYOE Human Sign-Off: Get a named human to review an agent action against a checklist and sign off on it. Poll /api/task?id= for the signed receipt. Priced on the amount at stake. Input: ?action=&counterparty=&amount= (counterparty required)
`dyoe_contacts`	$0.01	DYOE Contact Extraction: Extract public business emails, phone numbers, and social profiles from a website. Batch-safe contact enrichment for autonomous agents. Input: website URL. Returns structured JSON.
`dyoe_intel`	$0.10	DYOE Company Research: Research a company or website in one call: what they do, legitimacy verdict, domain age, how to reach them, social presence, scam red flags — background checks for agents. Sources disclosed, not a black box: RDAP registry domain age, HTTPS reachability, on-page contact signals, DYOE human-vouch registry. Input: ?target=domain
`dyoe_merchant`	$0.05	DYOE Store Safety Check: Is this online store safe to buy from? Scam/fraud check + trust verdict (safe/caution/avoid) + store signals (checkout, returns, payment methods) — counterparty trust for shopping & commerce agents before they pay. Input: ?url=
`dyoe_audit`	$0.05	DYOE Website Audit: Score any website 0-100 for legitimacy, trust, SEO and contactability — due diligence on a company in one call. Returns a verdict plus prioritized fixes. Input: ?url=domain
`dyoe_reputation`	$0.05	DYOE Reputation History: Look up the track record of any domain or wallet: how many times it has been assessed, verdict history, times flagged, first and last seen, a reputation score and a signed credential — a credit score for counterparties. Computed only from DYOE's own logged prior assessments; thin history is labeled as such. Input: ?target=
`dyoe_credential_org`	$0.10	DYOE Org Credential: Issue a signed, independently verifiable credential that a business domain passed a trust check — returns verdict, trust_score and domain_age. Input: ?domain=
`dyoe_token`	$0.05	DYOE Token Intelligence: Look up a token's price and market data plus a scam and rug-risk read on the project behind the coin — market data and counterparty trust in one call. Input: ?symbol=
`dyoe_extract`	$0.01	DYOE Text Extraction: Extract clean main text content from any web page (no nav/ads) — for research & summarizing agents. Input: ?url=
`dyoe_metadata`	$0.01	DYOE Page Metadata: Extract title, description, OpenGraph image, favicon & canonical from any URL — link previews & summaries. Input: ?url=
`dyoe_crypto`	$0.01	DYOE Crypto Price: Live crypto price + 24h change, market cap & volume for any coin — for trading agents. Input: ?symbol=btc
`dyoe_market`	$0.01	DYOE Crypto Market: Global crypto market overview — total market cap, 24h change, BTC/ETH dominance. Input: (none)
`dyoe_trending`	$0.01	DYOE Trending Coins: The coins trending right now — for trading & research agents. Input: (none)
`dyoe_movers`	$0.01	DYOE Top Movers: Top gainers & losers (24h) across the top 100 coins — for trading agents. Input: (none)
`dyoe_fx`	$0.01	DYOE Currency Conversion: Currency conversion + live exchange rate (ECB data). Input: ?from=USD&to=EUR&amount=100
`dyoe_weather`	$0.01	DYOE Weather: Current conditions + 3-day forecast for any city — for travel & planning agents. Input: ?city=Atlanta
`dyoe_wiki`	$0.01	DYOE Topic Summary: Factual summary of any topic from Wikipedia — for research agents. Input: ?topic=Bitcoin
`dyoe_destination`	$0.05	DYOE Destination Intel: Get what a trip-planning agent needs before it books, in one call: weather and 3-day forecast, local currency with live FX from USD, and a scam check on the booking site before it pays. Input: ?city=Athens&date=2026-11-20&currency=EUR&booking=hotel-site.com&budget=1500

Configuration

Variable	Default	Meaning
`WALLET_PRIVATE_KEY`	unset	A dedicated, low-balance Base wallet holding USDC. Unset = free preview (402 quotes only).
`DYOE_MAX_PAYMENT_USD`	`0.10`	Per-call cap. Calls priced above it are refused locally.
`DYOE_BASE_URL`	`https://agents.dyoeway.org`	Override the API origin (testing).

Safety

Use a burner wallet with a few dollars of USDC, never your main wallet.
The server signs only x402 payments for the tool you call, up to the per-call cap.
dyoe_approve and dyoe_review act on your behalf: they record an approval request with DYOE.

License

MIT