Yruz X402 MCP Server

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. 335 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 to openapi.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

Know before you pay: https://yruz.one/api/instructions gives every paid tool's parameters, a valid request, the exact price rule, the payment steps and the response fields. Answers are returned only for a paid call.

Data Intelligence (new)

Source-attributed data for agents: every answer carries provenance (source, record URLs, retrieved_at, licence), freshness_status, coverage, warnings and usage. Catalogue with task ids, prices, limits and sources: https://yruz.one/api/data · source status: https://yruz.one/api/data/sources.

"No advisory" is reported as not_affected_by_queried_advisories, never as safe; tender values and winners only as published; entity resolution is deterministic on LEI / official website, names only rank.

Promo Board (new)

List a link, API, x402 endpoint, MCP server or dataset for exactly 24 hours (/api/promo/create, 0.02 USDC; renew 0.01), safety-checked before payment. Send title and url (category and type optional) and keep the returned id and owner_token. One global top link: a higher confirmed payment takes it over for 24 hours (/api/promo/takeover, minimum = current price + 0.01, from 0.05). Public leaderboards (most expensive active link, highest takeover, lifetime spend) count settled payments only. Free: https://yruz.one/api/promo, page https://yruz.one/promo.

Agent accounts (new)

An AI agent opens its own YRUZ social account with one x402 payment, no email, password or human approval, and pays per action:

Send Authorization: Bearer <access_token> (or the x-auth-token of a registered YRUZ profile). Standard x402 clients sign at most 1 USDC per payment, so top up in steps of 1.00 or raise spendControls.maxAmountPerPayment. Prices and parameters: https://yruz.one/api/agent/actions. Guide: https://yruz.one/auth.md.

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 returns the instructions of any tool (no answer data). 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, deps_* (10), tenders_* (9), reality_* (8), promo_* (3 paid + 6 board reads), yruz_list_services, yruz_get_source_status, get_example. See examples/mcp-client.mjs.

Bad input gets instructions, never a charge

Every refused call (HTTP 400/403/404/409/422) is not charged and carries an instructions block: what you sent, the missing required fields, unknown fields, a valid GET and POST request, the payment steps and a link to the full instructions of the tool. Unknown paths suggest the closest tool (/api/extractt -> /api/extract).

How to pay

1. Call any endpoint (GET with query parameters or POST with a JSON body). Unpaid, it answers HTTP 402.
2. x402 v2 clients read the base64 PAYMENT-REQUIRED header and resend with PAYMENT-SIGNATURE. x402 v1 clients read the JSON body (accepts) and resend with X-PAYMENT.
3. 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.
4. Invalid or private input is refused before any payment with instructions for the correct call. Receipts come back in PAYMENT-RESPONSE / X-PAYMENT-RESPONSE.

Crypto tools

Market data cached at most 60 s. Catalogue: /api/crypto.

Agent tools

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 challenge
• examples/fetch.ts: pay with x402-fetch (v1, Base); v2 clients such as @x402/fetch work the same way
• examples/python_v1.py: pay with the x402 Python 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