# Onyx Actions — Paid Agent MCP (x402 USDC on Base + Solana)

> Onyx Actions is a paid Model Context Protocol server. AI agents pay per call in USDC over the x402 protocol — no API keys, no signup, no subscriptions. On-chain primitives for Base AND Solana mainnet, plus browser/web/utility tooling.

## Endpoints

- Remote MCP (HTTP, recommended): https://onyx-actions.onrender.com/mcp/
- Local stdio: `pip install onyx-paid-mcp && python -m onyx_paid_mcp.server`
- Source: https://github.com/dimitrilaouanis-tech/onyx-mcp
- Payment protocol: https://x402.org
- Network: Base mainnet (USDC). Base Sepolia for testing.

## How agents pay

1. Agent calls a tool. Server replies HTTP 402 with payment requirements (recipient, amount, scheme).
2. Agent signs an EIP-3009 USDC authorization with its wallet, includes it in the next request.
3. Server settles via the CDP x402 facilitator and returns the tool result.

No state is held between calls. No account exists. The wallet IS the identity.

## Tools (each priced per-call in USDC)

| Tool | What it does | Price |
| --- | --- | --- |
| base_tx_explainer | Decode any Base mainnet tx into a human-readable summary | $0.05 |
| base_tx_simulator | Pre-flight a Base tx — gas estimate + revert detection | $0.10 |
| base_token_risk_scan | Rug-vector scan for any Base ERC-20 (owner, mint, supply, code) | $0.25 |
| base_tx_decode | Raw tx ABI decode for Base | $0.002 |
| token_metadata | ERC-20 name/symbol/decimals/supply on Base | $0.001 |
| solana_tx_explainer | Decode any Solana mainnet tx into a human-readable summary (HALF OATP) | $0.05 |
| solana_token_metadata | SPL token name/symbol/decimals/supply via Mint+Metaplex | $0.0008 |
| solana_token_risk_scan | Rug-vector scan for SPL tokens (mint/freeze authority + concentration) | $0.25 |
| solana_jupiter_quote | Best-route swap quote across all Solana DEXes via Jupiter | $0.001 |
| solana_wallet_activity | Recent on-chain activity for any Solana wallet (parsed) | $0.002 |
| ens_resolve | ENS name ↔ address bidirectional resolve | $0.0008 |
| solve_captcha | OCR-based bypass for image captchas (~30ms, 70-90% accuracy) | $0.003 |
| url_text | Fetch a URL and return clean main-content text | $0.001 |
| url_unshorten | Resolve any redirect chain to its final URL | $0.0005 |
| dns_lookup | A / AAAA / PTR records for a host | $0.0005 |
| whois | WHOIS / RDAP registration data for a domain | $0.001 |
| email_validate | Syntax + DNS + role-account + disposable-domain check | $0.0008 |
| ip_geolocate | Country, region, city, ASN, proxy/hosting flags for IPv4/IPv6 | $0.0008 |
| user_agent_parse | Browser, OS, device, bot/crawler detection | $0.0003 |
| password_strength | Entropy + pattern score for a candidate password | $0.0003 |
| fx_convert | Mid-market FX conversion across 160+ currencies | $0.0008 |
| html_meta | OG / Twitter / JSON-LD extract from any URL | $0.0008 |
| jwt_decode | JWT inspector (header / payload / sig present) | $0.0003 |
| hash_compute | md5 / sha1 / sha256 / sha512 / sha3 | $0.0003 |
| robots_check | robots.txt fetch + path-allowed verdict | $0.0005 |
| url_parse | URL → structured components | $0.0003 |
| browser_navigate / screenshot / extract / click / type / eval | CDP browser automation suite | $0.002–$0.008 |
| agent_workflow | Compose up to 10 tools in one paid call | $0.020 |

## Why this exists

Most MCP servers expect free unlimited use. Real services cost money. x402 lets an MCP server bill per call without forcing the agent to open an account or hold an API key. Onyx Actions is the reference implementation of that pattern — every tool is real, every call settles on-chain, every agent pays the same price.

## Author

Onyx Council — https://github.com/dimitrilaouanis-tech/onyx-mcp

## Discovery

- agentic.market: indexed automatically on first settled mainnet payment
- x402 directories: x402-list.com · x402list.fun · x402.direct · signal402.com · x402daily.xyz
- awesome-x402: https://github.com/xpaysh/awesome-x402/pull/295 (open)
- Smithery: https://smithery.ai/servers/dimitrilaouanis/onyx-mcp
- Official MCP Registry submission via `mcp-publisher` (in flight)

## Build your own paid MCP

The `onyx-paid-mcp` Python framework that runs Onyx Actions is published on PyPI. Five lines stand up your own paid server. See the GitHub README for the full pattern.

## Contact

- GitHub Issues: https://github.com/dimitrilaouanis-tech/onyx-mcp/issues
- Repo discussions: https://github.com/dimitrilaouanis-tech/onyx-mcp/discussions