English Français العربية

io.github.Coinlooter/mcp

السجل الرسمي المالية والمدفوعات

PayFlowAgent suite: token intel, DeFi, enrich, Base trust (x402).

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

التثبيت

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

NPM package payflowagent-mcp
Claude Code 
claude mcp add io-github-coinlooter-mcp -e 'X402_BUYER_PRIVATE_KEY=<your x402_buyer_private_key>' -e 'PAYFLOWAGENT_API_BASE=<PAYFLOWAGENT_API_BASE>' -e 'PAYFLOWAGENT_DATAFEED_BASE=<PAYFLOWAGENT_DATAFEED_BASE>' -e 'PAYFLOWAGENT_ENRICH_BASE=<PAYFLOWAGENT_ENRICH_BASE>' -e 'PAYFLOWAGENT_TRUST_BASE=<PAYFLOWAGENT_TRUST_BASE>' -e 'X402_BUYER_RPC=<X402_BUYER_RPC>' -- npx -y payflowagent-mcp@0.1.6
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "io-github-coinlooter-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "payflowagent-mcp@0.1.6"
            ],
            "env": {
                "X402_BUYER_PRIVATE_KEY": "<your x402_buyer_private_key>",
                "PAYFLOWAGENT_API_BASE": "<PAYFLOWAGENT_API_BASE>",
                "PAYFLOWAGENT_DATAFEED_BASE": "<PAYFLOWAGENT_DATAFEED_BASE>",
                "PAYFLOWAGENT_ENRICH_BASE": "<PAYFLOWAGENT_ENRICH_BASE>",
                "PAYFLOWAGENT_TRUST_BASE": "<PAYFLOWAGENT_TRUST_BASE>",
                "X402_BUYER_RPC": "<X402_BUYER_RPC>"
            }
        }
    }
}

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

  • X402_BUYER_PRIVATE_KEY سري Private key of a dedicated payer wallet (Base, USDC) used to auto-pay x402 calls. Without it, only free tools work.
  • PAYFLOWAGENT_API_BASE Base URL of the nad.fun API (default https://nad.payflowagent.net).
  • PAYFLOWAGENT_DATAFEED_BASE Base URL of the Datafeed API (default https://data.payflowagent.net).
  • PAYFLOWAGENT_ENRICH_BASE Base URL of the Enrich API (default https://enrich.payflowagent.net).
  • PAYFLOWAGENT_TRUST_BASE Base URL of the Trust API (default https://trust.payflowagent.net).
  • X402_BUYER_RPC Optional payment RPC endpoint (Base mainnet by default).

التوثيق

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

المحتويات
  1. PayFlowAgent — MCP server & reference agent
  2. Tools (MCP)
  3. Install (one line)
  4. Use it in Cursor
  5. Use it in Claude Desktop
  6. MCP Registry
  7. Reference agent
  8. Develop locally
  9. Publish to npm
  10. License

PayFlowAgent — MCP server & reference agent

Pay-per-call APIs for autonomous AI agents. USDC via x402, no signup.

MCP registry name: io.github.Coinlooter/mcp

This repository contains the open-source integration pieces:

PathWhat
/ (root)payflowagent-mcp — MCP server for Cursor, Claude Desktop, and custom agents.
examples/screen-bot/Reference polling bot: finds high-score nad.fun tokens every few minutes.

The scoring APIs run on PayFlowAgent infrastructure; this repo is the client surface so agents and developers can integrate in one step.

Tools (MCP)

nad.fun (Monad)
ToolPriceDescription
score_tokenfree0–100 score, riskLevel, action (rate-limited).
decide_tokenx402Full report: factors, graduation, momentum.
token_summaryx402Graduation progress + momentum (cheap entry).
screen_tokensx402Ranked list of pre-scored fresh tokens.
Datafeed (DeFiLlama)
ToolPriceDescription
sample_yieldsfreeTop yield pools + 3-item opportunity preview (score + reasons).
yield_opportunitiesx402Ranked yield picks with risk score & explainable reasons.

Install (one line)

npx -y payflowagent-mcp@0.1.3

Use it in Cursor

~/.cursor/mcp.json (or project .cursor/mcp.json):

{
  "mcpServers": {
    "payflowagent": {
      "command": "npx",
      "args": ["-y", "payflowagent-mcp@0.1.3"],
      "env": {
        "PAYFLOWAGENT_API_BASE": "https://nad.payflowagent.net",
        "PAYFLOWAGENT_DATAFEED_BASE": "https://data.payflowagent.net"
      }
    }
  }
}

Use it in Claude Desktop

Same config as Cursor (Settings → Developer → MCP Servers).

Without X402_BUYER_PRIVATE_KEY only free tools work (score_token, sample_yields). Use a dedicated payer wallet (Base, USDC) — never your main wallet.

Configuration (env)
VariableDefaultPurpose
PAYFLOWAGENT_API_BASEhttps://nad.payflowagent.netnad.fun API base URL.
PAYFLOWAGENT_DATAFEED_BASEhttps://data.payflowagent.netDatafeed API base URL.
X402_BUYER_PRIVATE_KEY—Payer wallet key (Base, USDC). Enables paid tools.
X402_BUYER_RPChttps://mainnet.base.orgPayment RPC (optional).

MCP Registry

After npm publish, list in the official registry:

npm install -g @modelcontextprotocol/publisher
cd payflowagent-mcp
mcp-publisher login github
mcp-publisher publish

Manifest: server.json (io.github.Coinlooter/mcp).

Reference agent

See examples/screen-bot — polls /v1/screen every few minutes, de-duplicates, and alerts on new high-score tokens (optional webhook). Fork it and point it at your own trading logic.

Develop locally

npm install
npm run typecheck
npm run build      # emits dist/
npm start          # stdio server from source (tsx)

Publish to npm

npm run build
npm publish

License

MIT — see LICENSE.

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

ما هو io.github.Coinlooter/mcp؟

PayFlowAgent suite: token intel, DeFi, enrich, Base trust (x402).

كيف أثبّت io.github.Coinlooter/mcp؟

يعمل على جهازك. في Claude Code: claude mcp add io-github-coinlooter-mcp -e 'X402_BUYER_PRIVATE_KEY=<your x402_buyer_private_key>' -e 'PAYFLOWAGENT_API_BASE=<PAYFLOWAGENT_API_BASE>' -e 'PAYFLOWAGENT_DATAFEED_BASE=<PAYFLOWAGENT_DATAFEED_BASE>' -e 'PAYFLOWAGENT_ENRICH_BASE=<PAYFLOWAGENT_ENRICH_BASE>' -e 'PAYFLOWAGENT_TRUST_BASE=<PAYFLOWAGENT_TRUST_BASE>' -e 'X402_BUYER_RPC=<X402_BUYER_RPC>' -- npx -y payflowagent-mcp@0.1.6. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

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

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

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

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

من يصون io.github.Coinlooter/mcp؟

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

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