English Français العربية

io.github.Coinlooter/mcp

Official registry Finance and payments

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

Source code Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

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 configuration (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>"
            }
        }
    }
}

Environment variables

  • 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

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

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

Frequently asked questions

What is io.github.Coinlooter/mcp?

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

How do I install io.github.Coinlooter/mcp?

It runs on your machine. In 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. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.Coinlooter/mcp need an API key?

Yes. It expects X402_BUYER_PRIVATE_KEY, which you set in its configuration.

Is io.github.Coinlooter/mcp open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains io.github.Coinlooter/mcp?

It is published by Coinlooter. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.