PayFlowAgent — MCP server & reference agent

Name: payflowagent mcp
Author: coinlooter

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

MCP registry name: io.github.Coinlooter/mcp

Hub (catalog): payflowagent.net
nad.fun intelligence: nad.payflowagent.net
DeFi datafeed: data.payflowagent.net
npm: payflowagent-mcp@0.1.3

This repository contains the open-source integration pieces:

Path	What
`/` (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)

Tool	Price	Description
`score_token`	free	0–100 score, `riskLevel`, `action` (rate-limited).
`decide_token`	x402	Full report: factors, graduation, momentum.
`token_summary`	x402	Graduation progress + momentum (cheap entry).
`screen_tokens`	x402	Ranked list of pre-scored fresh tokens.

Datafeed (DeFiLlama)

Tool	Price	Description
`sample_yields`	free	Top yield pools + 3-item opportunity preview (score + reasons).
`yield_opportunities`	x402	Ranked 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)

Variable	Default	Purpose
`PAYFLOWAGENT_API_BASE`	`https://nad.payflowagent.net`	nad.fun API base URL.
`PAYFLOWAGENT_DATAFEED_BASE`	`https://data.payflowagent.net`	Datafeed API base URL.
`X402_BUYER_PRIVATE_KEY`	—	Payer wallet key (Base, USDC). Enables paid tools.
`X402_BUYER_RPC`	`https://mainnet.base.org`	Payment 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.