# agentgate-examples

Copy-paste starters for the nine AgentGate x402 tools. Every tool is pay-per-call in USDC on Base (x402 v2, v1 also accepted), has a free preview, and has a free remote MCP server. No accounts, no API keys.

| Tool | Paid endpoint | Price | Remote MCP | stdio MCP (runs locally, free) |
|---|---|---|---|---|
| AgentGate: AI agent identity (Concordium Agent Registry) | `GET https://api.youraitools.co/agentgate/v1/check-agent?id=` | $0.005 | `https://api.youraitools.co/agentgate/mcp` | `npx -y -p concordium-agentgate agentgate-mcp` |
| WebRead: web page to Markdown | `GET https://api.youraitools.co/webread/v1/read?url=` | $0.002 | `https://api.youraitools.co/webread/mcp` | `npx -y -p x402-url-to-markdown webread-mcp` |
| InjectScan: prompt-injection scan | `GET https://api.youraitools.co/injectscan/v1/scan?text=` | $0.003 | `https://api.youraitools.co/injectscan/mcp` | `npx -y -p x402-prompt-injection-scan injectscan-mcp` |
| DomainCheck: domain + email trust | `GET https://api.youraitools.co/domaincheck/v1/domain?domain=` | $0.002 ($0.001 email) | `https://api.youraitools.co/domaincheck/mcp` | `npx -y -p @agentgate-builder/domaincheck domaincheck-mcp` |
| PayGuard: OFAC SDN address screening | `GET https://api.youraitools.co/payguard/v1/address?address=` | $0.001 ($0.01 batch of 50) | `https://api.youraitools.co/payguard/mcp` | `npx -y -p @agentgate-builder/payguard payguard-mcp` |
| PkgGuard: dependency vulnerability + malicious-package scan (OSV.dev) | `GET https://api.youraitools.co/pkgguard/v1/package?ecosystem=npm&name=&version=` | $0.001 ($0.003 lockfile scan, `POST /v1/scan`) | `https://api.youraitools.co/pkgguard/mcp` | `npx -y -p @agentgate-builder/pkgguard pkgguard-mcp` |
| StackDetect: website technology / tech stack detection (CMS, hosting, analytics, email/DNS providers) | `GET https://api.youraitools.co/stackdetect/v1/detect?url=` | $0.003 | `https://api.youraitools.co/stackdetect/mcp` | `npx -y -p @agentgate-builder/stackdetect stackdetect-mcp` |
| TokenVerdict: Base token safety check (honeypot / sell simulation, buy and sell tax, owner powers, liquidity, holders; SAFE / CAUTION / DANGER) | `GET https://api.youraitools.co/tokenverdict/v1/quick?token=` | $0.015 ($0.005 lite, $0.05 deep) | `https://api.youraitools.co/tokenverdict/mcp` | `npx -y -p @agentgate-builder/tokenverdict tokenverdict-mcp` |
| SignCheck: pre-sign wallet safety check (transactions, Permit / Permit2 / EIP-3009 signatures, EIP-7702, x402 payments; SAFE / CAUTION / DANGER) | `POST https://api.youraitools.co/signcheck/v1/check` | $0.015 | `https://api.youraitools.co/signcheck/mcp` | `npx -y -p @agentgate-builder/signcheck signcheck-mcp` |

## Market-data tools for trading agents (read-only)

Used by the `langgraph/` and `mastra/` examples. Analytics only: these tools never trade, hold funds or touch keys. Not financial advice; past performance does not guarantee future results.

| Tool | Paid endpoints (x402, USDC) | Remote MCP (free preview tier) |
|---|---|---|
| PerpRadar: perp funding, open interest and premium across Hyperliquid, dYdX v4, Paradex, Aevo | `GET https://api.youraitools.co/perpradar/v1/lite?symbol=` $0.005 · `/v1/full` $0.03 · `/v1/scan` $0.02 | `https://api.youraitools.co/perpradar/mcp` |
| TASignal: indicators (RSI, MACD, EMA, Bollinger, ATR, ADX), risk (VaR/CVaR, drawdown), rule backtests | `GET https://api.youraitools.co/tasignal/v1/lite?symbol=&timeframe=` $0.005 · `/v1/risk` $0.02 · `/v1/backtest` $0.05 | `https://api.youraitools.co/tasignal/mcp` |
| SmartPerps: Hyperliquid top-trader cohort positioning per coin, flows, wallet profile | `GET https://api.youraitools.co/smartperps/v1/lite?symbol=` $0.003 · `/v1/coin` $0.02 · `/v1/scan` $0.03 · `/v1/wallet` $0.01 | `https://api.youraitools.co/smartperps/mcp` |
| SolVerdict: Solana SPL / Token-2022 mint safety check | `GET https://api.youraitools.co/solverdict/v1/lite?mint=` $0.005 · `/v1/check` $0.02 | `https://api.youraitools.co/solverdict/mcp` |

TokenVerdict and PayGuard are in the table above.

## What is here

| Path | What |
|---|---|
| `mcp/claude_desktop_config.json` | Claude Desktop, remote servers via `mcp-remote` |
| `mcp/claude_desktop_config.stdio.json` | Claude Desktop, local stdio packages via `npx` |
| `mcp/cursor.mcp.json`, `mcp/cursor.mcp.stdio.json` | Cursor (`~/.cursor/mcp.json` or `.cursor/mcp.json`), remote or stdio |
| `mcp/windsurf.mcp_config.json`, `mcp/windsurf.mcp_config.stdio.json` | Windsurf (`~/.codeium/windsurf/mcp_config.json`), remote or stdio |
| `typescript/` | Pay one tool with `@x402/fetch` + a viem account; `npm run dry-run` parses the 402 challenges of the first five tools without paying |
| `python/` | Same with the official `x402` Python SDK (requests); `python pay_one_tool.py --dry-run` |
| `agentkit/` | Coinbase AgentKit action provider (`customActionProvider`) that pays from the AgentKit EVM wallet |
| `langchain/js/` | LangChain.js tools (`tool()` + zod) |
| `langchain/python/` | LangChain Python tools (`StructuredTool`) |
| `openai-agents/` | OpenAI Agents SDK (Python): all nine remote MCP servers via `MCPServerStreamableHttp`; `python trust_kit_agent.py --smoke` lists the tools and calls two free ones with no LLM key |
| `langgraph/` | **Trading-research agent**, LangGraph (Python) + `langchain-mcp-adapters` `MultiServerMCPClient`: PerpRadar, TASignal, SmartPerps, TokenVerdict, SolVerdict and PayGuard as remote MCP servers, `create_react_agent` with any LangChain chat model; `python trading_agent.py --smoke` needs no LLM key or wallet |
| `mastra/` | **Trading-research agent**, Mastra (`@mastra/mcp` `MCPClient` + `@mastra/core` `Agent`): the same six servers; `npm run smoke` needs no LLM key or wallet |
| `vercel-ai-sdk/` | Vercel AI SDK (`ai` + `@ai-sdk/mcp` `createMCPClient`, HTTP transport): all nine remote MCP servers as `generateText` tools; `npm run smoke` needs no LLM key |

## Try it without spending anything

```bash
cd typescript && npm i && npm run build && npm run dry-run        # parses every 402: price, network, payTo
cd python && pip install -r requirements.txt && python pay_one_tool.py --dry-run
cd openai-agents && pip install -r requirements.txt && python trust_kit_agent.py --smoke   # free MCP tier, no wallet
cd vercel-ai-sdk && npm i && npm run smoke                                          # free MCP tier, no wallet
cd langgraph && pip install -r requirements.txt && python trading_agent.py --smoke  # trading tools, free MCP tier
cd mastra && npm i && npm run smoke                                                 # trading tools, free MCP tier
```

The AgentKit and LangChain dry runs (`npm run dry-run`, `python agentgate_tools.py`) go one step further: they sign a payment with a throwaway, empty wallet. The facilitator turns it down (`invalid_payload`), which shows the full 402, sign and verify loop works and no money moves.

## Pay for real

Set `BUYER_KEY` to the private key of a small hot wallet holding a few cents of USDC on Base (no ETH needed: x402 uses gasless EIP-3009 transfers). Keep it in the environment or a secrets manager, never in code.

```bash
BUYER_KEY=0x... node typescript/dist/pay-one-tool.js webread
BUYER_KEY=0x... python python/pay_one_tool.py payguard
```

Guides: https://youraitools.co/guides/pay-per-call-web-scraper-api · https://youraitools.co/guides/prompt-injection-scanner-api · https://youraitools.co/guides/x402-agent-verification

MIT licensed.