PayFlowAgent — MCP server & reference agent

Token intelligence for nad.fun tokens on Monad: decision-ready risk & momentum scores. Free to probe, pay-per-call in USDC via the x402 protocol.

• Service & live demo: https://payflowagent.net

• npm: payflowagent-mcp

• x402 manifest: https://payflowagent.net/.well-known/x402.json · OpenAPI: https://payflowagent.net/openapi.json · llms.txt: https://payflowagent.net/llms.txt

This repository contains the open-source integration pieces:

The scoring service itself runs at payflowagent.net; this repo is the client-side surface so agents and developers can integrate in one step.

Tools (MCP)

Related MCP server: AgentStamp

Use it in Cursor

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

{
  "mcpServers": {
    "payflowagent": {
      "command": "npx",
      "args": ["-y", "payflowagent-mcp"],
      "env": { "X402_BUYER_PRIVATE_KEY": "0x..." }
    }
  }
}

Use it in Claude Desktop

{
  "mcpServers": {
    "payflowagent": {
      "command": "npx",
      "args": ["-y", "payflowagent-mcp"],
      "env": { "X402_BUYER_PRIVATE_KEY": "0x..." }
    }
  }
}

Without X402_BUYER_PRIVATE_KEY only the free score_token tool works. Use a dedicated payer wallet (Base, USDC) — never your main wallet.

Configuration (env)

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          # runs the stdio server from source (tsx)

License

MIT — see LICENSE.