agentgate-examples / tree / README.md · raw (this view has old GitHub links rewritten for the mirror; raw is byte-exact)

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

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.

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.


agentgate-source: code mirror on Cloudflare Pages. All repos