YRUZ x402 tools
Pay-per-call x402 tools: package advisories, EU tenders, Wikidata facts, promo board, web, crypto
التثبيت
أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: .cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).
claude mcp add --transport http yruz-x402-tools 'https://yruz.one/mcp/x402'
{
"mcpServers": {
"yruz-x402-tools": {
"type": "http",
"url": "https://yruz.one/mcp/x402"
}
}
}
التوثيق
مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.
المحتويات
YRUZ x402 API
Fast pay-per-call APIs for AI agents over x402 v1 and v2. Pay in USDC on Solana or Base (same price on both), no account, no API key, no signup. 275 paid operations, every one answering both x402 v2 (PAYMENT-REQUIRED header) and x402 v1 (JSON body), with Base and Solana offers in each 402.
- Discovery manifest: https://yruz.one/.well-known/x402
- OpenAPI 3.1 (with
x-payment-info): https://yruz.one/openapi.json (x402 operations copied toopenapi.json) - APIs.json: https://yruz.one/.well-known/apis.json
- Agent docs: https://yruz.one/llms.txt · https://yruz.one/auth.md · live prices and readiness: https://yruz.one/x402.php
- Facilitators: OpenFacilitator, PayAI, Dexter (they pay the network fee; the buyer only needs USDC)
Best sellers
| Endpoint | What it does | USDC |
|---|---|---|
/api/audit | Website audit: TLS, security headers, HTTP/2-3, SEO and AI-agent readiness, scored with fixes | 0.01 |
/api/extract | Any web page as clean Markdown (code blocks, tables, lists) with metadata | 0.005 |
/api/enrich | Company profile from a domain: name, logo, socials, emails, phones, email provider, tech stack, registration | 0.01 |
/api/safety | Is a link safe to open, sign or pay? Redirects, domain age, look-alikes, brand impersonation, wallet drainers | 0.005 |
/api/weather | Current weather, 48 h hourly and 7-day forecast, US alerts, by place name or lat/lon | 0.003 |
/api/domain | DNS, SPF/DMARC/DKIM/MTA-STS, RDAP registration and TLS of a domain, scored | 0.01 |
/api/crypto/token | Solana token rug-pull check: authorities, holders, liquidity, risk score | 0.005 |
See before you pay: https://yruz.one/api/examples returns a real recorded answer of every paid tool, free.
Use it over MCP
The same tools are an MCP server, no auth: https://yruz.one/mcp/x402 (streamable HTTP, stateless).
Payments follow the x402 MCP transport:
an unpaid tools/call returns isError with the PaymentRequired in structuredContent; repeat it with the signed
PaymentPayload in params._meta["x402/payment"]; the receipt comes back in result._meta["x402/payment-response"].
get_example is free. Listed in the official MCP Registry as io.github.xzntexe/yruz-x402. Server card: https://yruz.one/.well-known/mcp/x402-server-card.json.
Tools: site_audit, web_extract, company_enrich, url_safety_check, weather_forecast, link_preview, domain_intel, broken_links, uptime_check, x402_endpoint_check,
wallet_balance, crypto_price, crypto_trending, solana_token_check, solana_portfolio, solana_tx_explain,
network_fees, get_example. See examples/mcp-client.mjs.
Bad input is free
Every refused call (HTTP 400/404/422) is free and says how to succeed: charged: false, the endpoint, its parameters, a valid example call, the price and the docs. Unknown paths suggest the closest tool (/api/extractt -> /api/extract).
How to pay
- Call any endpoint (GET with query parameters or POST with a JSON body). Unpaid, it answers HTTP 402.
- x402 v2 clients read the base64
PAYMENT-REQUIREDheader and resend withPAYMENT-SIGNATURE. x402 v1 clients read the JSON body (accepts) and resend withX-PAYMENT. - Every 402 offers Base (
eip155:8453) and Solana (solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp). The payment is bound to the exact input, so change nothing between the 402 and the paid retry. - Invalid or private input is refused with a free 400 before any payment. Receipts come back in
PAYMENT-RESPONSE/X-PAYMENT-RESPONSE.
Crypto tools
Market data cached at most 60 s. Free catalogue: /api/crypto.
| Endpoint | What it does | USDC |
|---|---|---|
/api/crypto/price | Get live crypto prices for coins and Solana tokens | 0.002 |
/api/crypto/trending | Get trending coins, top gainers and losers | 0.003 |
/api/crypto/token | Check a Solana token for rug-pull risk | 0.005 |
/api/crypto/portfolio | Get the tokens and USD value of a Solana wallet | 0.005 |
/api/crypto/tx | Get a Solana transaction explained in plain words | 0.003 |
/api/crypto/fees | Get Solana priority fees and Base gas in USD | 0.002 |
Agent tools
| Endpoint | What it does | USDC |
|---|---|---|
/api/extract | Extract a web page as clean Markdown with metadata | 0.005 |
/api/unfurl | Get the link preview card of a URL | 0.003 |
/api/domain | Check DNS, email security and RDAP of a domain | 0.01 |
/api/links | Check every link on a page for broken URLs | 0.01 |
/api/x402-check | Check that a paid x402 endpoint answers a valid 402 | 0.005 |
/api/uptime | Check if a website is up and how fast it answers | 0.003 |
/api/wallet | Get USDC and gas balance of a Solana or Base wallet | 0.002 |
/api/audit | Check the security, speed and SEO of a website | 0.01 |
/api/trending | What is moving on the YRUZ social network | 0.005 |
Social data, utilities and toolkit
- Social data (public YRUZ content):
/api/search,/api/posts,/api/post,/api/profile,/api/profile/posts,/api/article,/api(articles as Markdown),/api/forums,/api/thread,/api/questions,/api/question,/api/pages,/api/page. From 0.002 USDC; lists 0.002 + 0.0005 per item. - Developer utilities (catalogue):
/api/util/<tool>: time, uuid, random, password, ip, hash, hmac, base64, urlencode, slug, wordcount, case, json, jwt-decode, html2md, color, email, dns. 0.002 USDC. - YRUZ Toolkit (catalogue): 90+ tools at
/api/toolkit/<slug>(ssl-lookup, http-headers-lookup, meta-tags-checker, dns-lookup, url-redirect-checker ...) and 1,700+ conversions at/api/toolkit/convert?from=&to=&value=. 0.002 USDC.
Examples
examples/curl.sh: see the 402 challengeexamples/fetch.ts: pay withx402-fetch(v1, Base); v2 clients such as@x402/fetchwork the same wayexamples/python_v1.py: pay with thex402Python client (v1)
Listed on
x402scan · agent402 · 402index · PayAPI Market · agent-tools.cloud · nohumans
Payment addresses
- Solana:
CWfaj5vDppWCp4q1X4iPYGWpCGY2Rerj9DQWqxTnz1Pp - Base:
0x235b73D50752800D9FaE24F51bEb08f47076c67A
Contact: zanto@yruz.one · Website: https://yruz.one
الأسئلة الشائعة
ما هو YRUZ x402 tools؟
Pay-per-call x402 tools: package advisories, EU tenders, Wikidata facts, promo board, web, crypto
كيف أثبّت YRUZ x402 tools؟
يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http yruz-x402-tools 'https://yruz.one/mcp/x402'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.
هل يحتاج YRUZ x402 tools إلى مفتاح API؟
لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.
هل YRUZ x402 tools مفتوح المصدر؟
شيفرته علنية على GitHub، لكن المستودع لا يعلن ترخيصًا قياسيًا.
من يصون YRUZ x402 tools؟
ينشره xzntexe. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.
من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.