{
  "markdown": "# PayFlowAgent — MCP server & reference agent\n\nPay-per-call APIs for autonomous AI agents. **USDC via x402**, no signup.\n\n**MCP registry name:** `io.github.Coinlooter/mcp`\n\n- **Hub (catalog):** [payflowagent.net](https://payflowagent.net)\n- **nad.fun intelligence:** [nad.payflowagent.net](https://nad.payflowagent.net)\n- **DeFi datafeed:** [data.payflowagent.net](https://data.payflowagent.net)\n- **npm:** [`payflowagent-mcp@0.1.3`](https://www.npmjs.com/package/payflowagent-mcp)\n\nThis repository contains the open-source integration pieces:\n\n| Path | What |\n|------|------|\n| `/` (root) | **`payflowagent-mcp`** — MCP server for Cursor, Claude Desktop, and custom agents. |\n| `examples/screen-bot/` | Reference polling bot: finds high-score nad.fun tokens every few minutes. |\n\n> The scoring APIs run on PayFlowAgent infrastructure; this repo is the client surface\n> so agents and developers can integrate in one step.\n\n## Tools (MCP)\n\n### nad.fun (Monad)\n\n| Tool | Price | Description |\n|------|-------|-------------|\n| `score_token` | free | 0–100 score, `riskLevel`, `action` (rate-limited). |\n| `decide_token` | x402 | Full report: factors, graduation, momentum. |\n| `token_summary` | x402 | Graduation progress + momentum (cheap entry). |\n| `screen_tokens` | x402 | Ranked list of pre-scored fresh tokens. |\n\n### Datafeed (DeFiLlama)\n\n| Tool | Price | Description |\n|------|-------|-------------|\n| `sample_yields` | free | Top yield pools + 3-item opportunity preview (score + reasons). |\n| `yield_opportunities` | x402 | Ranked yield picks with risk score & explainable reasons. |\n\n## Install (one line)\n\n```bash\nnpx -y payflowagent-mcp@0.1.3\n```\n\n## Use it in Cursor\n\n`~/.cursor/mcp.json` (or project `.cursor/mcp.json`):\n\n```json\n{\n  \"mcpServers\": {\n    \"payflowagent\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"payflowagent-mcp@0.1.3\"],\n      \"env\": {\n        \"PAYFLOWAGENT_API_BASE\": \"https://nad.payflowagent.net\",\n        \"PAYFLOWAGENT_DATAFEED_BASE\": \"https://data.payflowagent.net\"\n      }\n    }\n  }\n}\n```\n\n## Use it in Claude Desktop\n\nSame config as Cursor (Settings → Developer → MCP Servers).\n\nWithout `X402_BUYER_PRIVATE_KEY` only free tools work (`score_token`, `sample_yields`).\nUse a **dedicated** payer wallet (Base, USDC) — never your main wallet.\n\n### Configuration (env)\n\n| Variable | Default | Purpose |\n|----------|---------|---------|\n| `PAYFLOWAGENT_API_BASE` | `https://nad.payflowagent.net` | nad.fun API base URL. |\n| `PAYFLOWAGENT_DATAFEED_BASE` | `https://data.payflowagent.net` | Datafeed API base URL. |\n| `X402_BUYER_PRIVATE_KEY` | — | Payer wallet key (Base, USDC). Enables paid tools. |\n| `X402_BUYER_RPC` | `https://mainnet.base.org` | Payment RPC (optional). |\n\n## MCP Registry\n\nAfter npm publish, list in the official registry:\n\n```bash\nnpm install -g @modelcontextprotocol/publisher\ncd payflowagent-mcp\nmcp-publisher login github\nmcp-publisher publish\n```\n\nManifest: `server.json` (`io.github.Coinlooter/mcp`).\n\n## Reference agent\n\nSee [`examples/screen-bot`](examples/screen-bot) — polls `/v1/screen` every few\nminutes, de-duplicates, and alerts on new high-score tokens (optional webhook).\nFork it and point it at your own trading logic.\n\n## Develop locally\n\n```bash\nnpm install\nnpm run typecheck\nnpm run build      # emits dist/\nnpm start          # stdio server from source (tsx)\n```\n\n## Publish to npm\n\n```bash\nnpm run build\nnpm publish\n```\n\n## License\n\nMIT — see [LICENSE](LICENSE).\n",
  "bytes": 3442,
  "sha": "b7b055844674922174ee9d971955952222156808b9ea0e778cc08bc989cb3ff0",
  "repo_slug": "coinlooter/payflowagent-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_coinlooter_mcp_ac67e1c5/readme"
}