English Français العربية

io.github.Coinlooter/mcp

Registre officiel Finance et paiements

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

Code source Documentation

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « 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
Configuration 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>"
            }
        }
    }
}

Variables d'environnement

  • X402_BUYER_PRIVATE_KEY secret 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).

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  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.

Questions fréquentes

Qu'est-ce que io.github.Coinlooter/mcp ?

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

Comment installer io.github.Coinlooter/mcp ?

Il s'exécute sur votre machine. Dans 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. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour io.github.Coinlooter/mcp ?

Oui. Il attend X402_BUYER_PRIVATE_KEY, à renseigner dans sa configuration.

io.github.Coinlooter/mcp est-il open source ?

Oui. Son code est sur GitHub sous licence MIT.

Qui maintient io.github.Coinlooter/mcp ?

Il est publié par Coinlooter. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.