English Français العربية

io.github.pgalyen1987/gate402-mcp

السجل الرسمي البحث والويب

x402 pay-per-call agent APIs: LLM inference, Base trading data, SEC filings & scraping

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

NPM package gate402-mcp
Claude Code 
claude mcp add gate402-mcp -e 'GATE402_API_KEY=<your gate402_api_key>' -e 'GATE402_BASE_URL=<GATE402_BASE_URL>' -- npx -y gate402-mcp@0.8.1
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "gate402-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "gate402-mcp@0.8.1"
            ],
            "env": {
                "GATE402_API_KEY": "<your gate402_api_key>",
                "GATE402_BASE_URL": "<GATE402_BASE_URL>"
            }
        }
    }
}

متغيرات البيئة

  • GATE402_API_KEY سري Optional. A funded Gate402 account key to skip the free tier.
  • GATE402_BASE_URL Optional. Override the gateway base URL (default https://gate402.app).

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. gate402-mcp
  2. How billing works
  3. Install
  4. Configure your MCP client
  5. Environment variables
  6. Develop
  7. License

gate402-mcp

MCP server for Gate402 — pay-per-call agent APIs over HTTP 402 (x402 / USDC on Base). Gives any MCP client a full toolkit with no signup and a free tier on first runs — GPU/CPU compute, open-model LLM inference, a GPU marketplace, a complete Base trading loop (discover → vet → read → execute), and web tools:

ToolWhat it doesPrice
gate402_inferOpen-model LLM inference (Llama 3.1 8B/70B, Qwen 2.5, Mistral); billed on actual tokens, signed usage receiptper-token (from $0.05/1M in)
gate402_computeMetered GPU/CPU for a container job, with a signed execution receipt. Not available yet: answers 503 until a compute provider is connectedper-second
gate402_scrapeFetch any public URL, render JS, strip nav/ads → clean LLM-ready Markdown$0.002
gate402_scrape_stealthCloudflare/anti-bot fetch via residential proxies + CAPTCHA solving → clean Markdown$0.05
gate402_minifyCompress text to cut downstream LLM token spend (~40%)$0.005 / 10k tok
gate402_dedupSemantic vector-cache lookup (exact + cosine)$0.001 hit / $0.003 miss
gate402_onchainOn-chain wallet/token intel on Base (balances, EOA/contract, tx count, token metadata)$0.01
gate402_dexLive DEX price / liquidity / 24h volume for a Base token$0.01
gate402_newsRecent news headlines + bull/bear sentiment for a ticker/topic$0.02
gate402_edgarLatest SEC EDGAR filings (10-K/10-Q/8-K) for a US ticker$0.02
gate402_token_riskRug/tradeability verdict for a Base token (score + SAFE/CAUTION/AVOID; liquidity, honeypot sim, holder concentration)$0.03
gate402_momentumMomentum + order-flow signal for a Base token (RISING/FALLING + ACCUMULATION/DISTRIBUTION, honeypot-gated)$0.02
gate402_best_swapBest-execution intel: which DEX pool + estimated price impact for a trade size$0.02
gate402_launchesRadar of the freshest Base token launches, lightly pre-screened$0.02

…plus three free tools that run locally in this process (pure compute — no payment, no key, no network):

ToolWhat it does
gate402_token_countEstimate the token count of a string (budget your context window)
gate402_html_to_mdConvert an HTML string you already have into clean Markdown
gate402_json_repairCoerce malformed / LLM-mangled JSON into valid JSON
GPU marketplace

Gate402 also routes to third-party GPU/compute providers with escrow-on-success — the buyer is charged only if the provider delivers. Providers keep 85% of each call, paid out on-chain in USDC on Base.

ToolWhat it does
gate402_market_inferLLM inference via the marketplace, routed to the cheapest healthy provider. x402-native (settles on-chain per call — needs an x402 client, not the free-tier key)
gate402_providersFree. Browse active providers — model, per-call price, reliability
gate402_become_providerFree. List your own GPU and earn 85%/call — returns the exact sign-message + registration request

How billing works

On first use the server self-claims a free-credit API key from Gate402 and caches it at ~/.gate402-mcp/key.json. Calls draw down that credit. When it runs out, tools return a top-up link instead of failing. To skip the free tier, set GATE402_API_KEY to a funded account (top up).

The payment is the auth — there are no accounts to create.

Install

npm install -g gate402-mcp

Or run without installing via npx gate402-mcp.

Configure your MCP client

Claude Desktop / Claude Code

Add to your MCP config (claude_desktop_config.json, or claude mcp add):

{
  "mcpServers": {
    "gate402": {
      "command": "npx",
      "args": ["-y", "gate402-mcp"]
    }
  }
}
Cursor / Cline / Windsurf

Same shape — point the MCP server command at npx -y gate402-mcp.

Agent frameworks (LangChain, CrewAI, LlamaIndex)

gate402 is a standard stdio MCP server, so any framework with an MCP adapter can load all 17 tools:

LangChain / LangGraph (langchain-mcp-adapters):

from langchain_mcp_adapters.client import MultiServerMCPClient
client = MultiServerMCPClient({"gate402": {"command": "npx", "args": ["-y", "gate402-mcp"], "transport": "stdio"}})
tools = await client.get_tools()   # feed into your agent

CrewAI (MCPServerAdapter):

from crewai_tools import MCPServerAdapter
from mcp import StdioServerParameters
params = StdioServerParameters(command="npx", args=["-y", "gate402-mcp"])
with MCPServerAdapter(params) as tools:
    ...  # pass tools to your Crew

LlamaIndex (McpToolSpec):

from llama_index.tools.mcp import BasicMCPClient, McpToolSpec
tools = McpToolSpec(client=BasicMCPClient("npx", args=["-y", "gate402-mcp"])).to_tool_list()

Once wired, the agent calls the tools autonomously; the free-credit key is claimed on first use, and paid tools draw down from it.

Environment variables

VarDefaultPurpose
GATE402_API_KEY(unset)Use a funded account instead of the free tier.
GATE402_BASE_URLhttps://gate402.appOverride the gateway (self-hosting / testing).
GATE402_CONFIG_DIR~/.gate402-mcpWhere the cached free key is stored.

Develop

npm install
npm run build
npm start          # or: npm run dev

License

MIT

الأسئلة الشائعة

ما هو io.github.pgalyen1987/gate402-mcp؟

x402 pay-per-call agent APIs: LLM inference, Base trading data, SEC filings & scraping

كيف أثبّت io.github.pgalyen1987/gate402-mcp؟

يعمل على جهازك. في Claude Code: claude mcp add gate402-mcp -e 'GATE402_API_KEY=<your gate402_api_key>' -e 'GATE402_BASE_URL=<GATE402_BASE_URL>' -- npx -y gate402-mcp@0.8.1. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.pgalyen1987/gate402-mcp إلى مفتاح API؟

نعم. يتطلب GATE402_API_KEY، وتضبطها في إعداداته.

هل io.github.pgalyen1987/gate402-mcp مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون io.github.pgalyen1987/gate402-mcp؟

ينشره pgalyen1987. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.