dyoe-agent-tools-mcp
<!-- mcp-name: io.github.bjyoe2016/dyoe-trust-mcp -->
# dyoe-trust-mcp
MCP server for **DYOE**, the trust layer for AI agents. It gives Claude, Cursor or any MCP client 23 pay-per-call tools
from [agents.dyoeway.org](https://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](https://x402.org)**. 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:
```json
{
"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):
```json
{
"mcpServers": {
"dyoe": {
"command": "npx",
"args": ["-y", "dyoe-trust-mcp"],
"env": { "WALLET_PRIVATE_KEY": "", "DYOE_MAX_PAYMENT_USD": "0.10" }
}
}
}
```
### Any MCP client
```bash
npx -y dyoe-trust-mcp # stdio
```
## Tools (23)
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: Use when an agent is about to trust or pay a new website, merchant or counterparty: a trust check before payment. Is this website or business a scam? Fraud, phishing and rug-risk screen of a domain or URL. Returns verdict (safe/caution/avoid), trust_score, domain age, red_flags and a signed attestation. Proceed on safe, pause on caution, stop on avoid. Input: ?target=domain |
| `dyoe_transaction` | $0.10 | DYOE Payment Pre-Flight: Use when an agent needs a payment preflight: check before sending money to a merchant or wallet. One preflight transaction call: is the counterparty site legit, is the payee wallet OFAC-sanctioned or an empty, disposable address, is the amount over the policy line? 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: Use when an agent needs a wallet risk check before sending funds to a crypto address. Screens the address against the OFAC sanctions list and reads its on-chain footprint on Base (tx count, balance, contract or not; flags an empty, disposable address), with a human-vouch overlay. Returns verdict (safe/caution/avoid), sanctioned flag, on_chain activity, red_flags and a signed attestation. Input: ?address=0x... |
| `dyoe_approve` | $0.02 | DYOE Policy Authorization: Use when an agent needs a yes or no on an action before it acts, without waiting for a person. Approves or denies instantly against a human-set policy: a trust check on the counterparty plus an amount limit. Returns approved/denied/review_required with reasons and a signed receipt; anything over the policy line or with a caution counterparty escalates to /review. Input: ?action=&counterparty=&amount= (counterparty required) |
| `dyoe_review` | $15.00 | DYOE Human Sign-Off: Use when the stakes are high enough that a named human should sign off before an agent acts. A person reviews the action and counterparty and approves or denies; poll /api/task?id=<id> for the signed receipt. A counterparty that fails the trust check is denied at once. Input: ?action=&counterparty=&amount= (counterparty required) |
| `dyoe_contacts` | $0.01 | DYOE Contact Extraction: Use when an agent needs an email lookup or phone lookup for a business website. Extracts public business emails, phone numbers and social profiles from the page plus up to 4 same-site contact/about pages, then its privacy page if those list none. Verified or free: if no email or phone is found, or the site blocks us, the payment is not settled. Batch-safe contact enrichment for autonomous agents. Input: website URL. Returns structured JSON. |
| `dyoe_intel` | $0.10 | DYOE Company Research: Use when an agent needs a background check on a company or website before dealing with it. One call: what they do, legitimacy verdict, domain age, how to reach them, social presence, scam red flags. 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: Use when a shopping agent must verify seller trust before paying an online store. Is this store safe to buy from? Returns safe_to_buy, a trust verdict (safe/caution/avoid), trust_score, domain age, red_flags and store signals (cart/checkout, returns policy, payment methods mentioned on the page). Input: ?url= |
| `dyoe_audit` | $0.05 | DYOE Website Audit: Use when an agent needs a quick legitimacy and quality read on a website before relying on it. Scores any site 0-100 for legitimacy, trust, SEO and contactability; returns a grade, a legitimacy rating (strong/moderate/weak) and prioritized fixes. Input: ?url=domain |
| `dyoe_reputation` | $0.05 | DYOE Reputation History: Use when an agent wants a counterparty's track record, not just a fresh check. Look up 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. 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: Use when an agent or business needs portable proof that a domain passed a trust check. Issues a signed, independently verifiable credential (valid 7 days) with verdict, trust_score and domain_age_days. Input: ?domain= |
| `dyoe_token` | $0.05 | DYOE Token Intelligence: Use when a trading agent needs a coin's market data and a read on the project behind it. Returns price, 24h change, market cap and rank, plus project_risk (low/medium/high/unknown) from a scam and rug-risk trust check on the project's official site. Input: ?symbol= |
| `dyoe_extract` | $0.01 | DYOE Text Extraction: Use when a research or summarizing agent needs the readable text of a web page. Extracts clean main text (no scripts, nav, header, footer or forms) with title and word count. Input: ?url= |
| `dyoe_metadata` | $0.01 | DYOE Page Metadata: Use when an agent needs a link preview or a quick read of what a URL is. Extracts title, description, OpenGraph title/image/type, site name, favicon, canonical URL and language. Input: ?url= |
| `dyoe_crypto` | $0.01 | DYOE Crypto Price: Use when a trading agent needs the current price of a coin. Live crypto price + 24h change, market cap & volume for any coin. Input: ?symbol=btc |
| `dyoe_market` | $0.01 | DYOE Crypto Market: Use when an agent needs the state of the whole crypto market. Global overview: total market cap, 24h volume and change, BTC/ETH dominance, number of active coins. Input: (none) |
| `dyoe_trending` | $0.01 | DYOE Trending Coins: Use when a trading or research agent wants to know which coins are getting attention right now. Returns the top 7 trending coins with symbol, name and market-cap rank. Input: (none) |
| `dyoe_movers` | $0.01 | DYOE Top Movers: Use when a trading agent wants the day's biggest moves. Top 5 gainers and top 5 losers (24h) across the top 100 coins by market cap. Input: (none) |
| `dyoe_fx` | $0.01 | DYOE Currency Conversion: Use when an agent needs to convert an amount between currencies. Live exchange rate (ECB data) plus the converted amount. Input: ?from=USD&to=EUR&amount=100 |
| `dyoe_weather` | $0.01 | DYOE Weather: Use when a travel or planning agent needs the weather in a city. Current conditions (temperature, humidity, wind) + 3-day high/low forecast. Input: ?city=Atlanta |
| `dyoe_wiki` | $0.01 | DYOE Topic Summary: Use when a research agent needs a short factual summary of a topic. Returns the Wikipedia summary, short description and page link. Input: ?topic=Bitcoin |
| `dyoe_destination` | $0.05 | DYOE Destination Intel: Use when a trip-planning agent is about to book. 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¤cy=EUR&booking=hotel-site.com&budget=1500 |
| `dyoe_x402_check` | $0.05 | DYOE x402 Check-Up: Use when a seller wants to test their own x402 endpoint the way buyers and indexers see it: returns 402 unpaid, terms parse, payTo valid, price within the $0.10 default client cap, v1 body + v2 header, description under 500 chars, input schema present, response time. Returns pass/warn/fail with a fix list. Free if the URL is bad or unreachable. Input: ?url=https://seller/paid-path&method=GET\|POST |
## 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
TDQS
Scored across 22 tools
There is a heavy overlap cluster of website/domain trust tools: dyoe_verify, dyoe_merchant, dyoe_intel, and dyoe_audit all return legitimacy/trust verdicts on a URL, differing only by framing (scam check vs. store signals vs. research vs. 0-100 score). Similarly dyoe_crypto and dyoe_token both return price/market data for a coin, and dyoe_verify overlaps with dyoe_wallet (wallets) and dyoe_transaction (whole-payment vetting). An agent will frequently struggle to pick the right one.
Every tool follows a uniform dyoe_<single-word> snake_case pattern with no camelCase or stylistic drift. Mixing nouns (dyoe_weather, dyoe_crypto) and verbs (dyoe_verify, dyoe_approve) is still internally predictable and readable.
22 tools sits in the heavy range and reflects a grab-bag of unrelated domains (fraud checks, payments, crypto markets, web extraction, weather, FX, Wikipedia). The count is defensible for the breadth but several tools could be consolidated (e.g. weather/FX folded into dyoe_destination).
Across its apparent domains the surface is fairly complete: fraud/wallet/merchant vetting, policy approval and human review, crypto market data, web extraction, and utility lookups all have coverage. The lack of a single coherent domain makes gaps hard to pin down, but no obvious core operation is missing.