Back to Browse

Payflowagent MCP Server

Developer ToolsLow Risk10.0MCP RegistryLocal
Free

Server data from the Official MCP Registry

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

About

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

Security Report

10.0
Low Risk10.0Low Risk

Valid MCP server (2 strong, 3 medium validity signals). No known CVEs in dependencies. Package registry verified. Imported from the Official MCP Registry.

7 files analyzed · 1 issue found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

env_vars

Check that this permission is expected for this type of plugin.

HTTP Network Access

Connects to external APIs or services over the internet.

What You'll Need

Set these up before or after installing:

Private key of a dedicated payer wallet (Base, USDC) used to auto-pay x402 calls. Without it, only free tools work.Required

Environment variable: X402_BUYER_PRIVATE_KEY

Base URL of the nad.fun API (default https://nad.payflowagent.net).Optional

Environment variable: PAYFLOWAGENT_API_BASE

Base URL of the Datafeed API (default https://data.payflowagent.net).Optional

Environment variable: PAYFLOWAGENT_DATAFEED_BASE

Base URL of the Enrich API (default https://enrich.payflowagent.net).Optional

Environment variable: PAYFLOWAGENT_ENRICH_BASE

Base URL of the Trust API (default https://trust.payflowagent.net).Optional

Environment variable: PAYFLOWAGENT_TRUST_BASE

Optional payment RPC endpoint (Base mainnet by default).Optional

Environment variable: X402_BUYER_RPC

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "io-github-coinlooter-mcp": {
      "env": {
        "X402_BUYER_RPC": "your-x402-buyer-rpc-here",
        "PAYFLOWAGENT_API_BASE": "your-payflowagent-api-base-here",
        "X402_BUYER_PRIVATE_KEY": "your-x402-buyer-private-key-here",
        "PAYFLOWAGENT_TRUST_BASE": "your-payflowagent-trust-base-here",
        "PAYFLOWAGENT_ENRICH_BASE": "your-payflowagent-enrich-base-here",
        "PAYFLOWAGENT_DATAFEED_BASE": "your-payflowagent-datafeed-base-here"
      },
      "args": [
        "-y",
        "payflowagent-mcp"
      ],
      "command": "npx"
    }
  }
}

Documentation

View on GitHub

From the project's GitHub README.

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

Reviews

No reviews yet

Be the first to review this server!