mcpField
C
Coinlooter

Coinlooter

Local
github.com/CoinlooterFinance0Updated 17w ago
Repository

About Coinlooter

Coinlooter is an MCP server for agents and developers working with nad.fun token intelligence and DeFi yield data. It provides scoring, screening and yield tools, with selected reports available through x402 payments in USDC on Base.

Key features

  1. 01nad.fun token scoring and reports
  2. 02Fresh-token screening and summaries
  3. 03DeFi yield samples and ranked opportunities
  4. 04x402 payments for selected tools
  5. 05Reference bot for high-score token alerts

Use cases

  1. 01Assessing a nad.fun token’s risk and momentum
  2. 02Finding ranked DeFi yield opportunities
  3. 03Polling for new high-score tokens and sending alerts

MCP support

The server exposes token-intelligence and DeFi datafeed tools to MCP clients. Free tools work without a payer key; x402-enabled tools use a Base USDC payer wallet.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "coinlooter": {
      "command": "npx",
      "args": [
        "-y",
        "payflowagent-mcp"
      ],
      "env": {
        "X402_BUYER_PRIVATE_KEY": "<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>"
      }
    }
  }
}
Run commandnpx -y payflowagent-mcp
Environment variables to set
X402_BUYER_PRIVATE_KEYSecretPrivate key of a dedicated payer wallet (Base, USDC) used to auto-pay x402 calls. Without it, only free tools work.
PAYFLOWAGENT_API_BASEBase URL of the nad.fun API (default https://nad.payflowagent.net).
PAYFLOWAGENT_DATAFEED_BASEBase URL of the Datafeed API (default https://data.payflowagent.net).
PAYFLOWAGENT_ENRICH_BASEBase URL of the Enrich API (default https://enrich.payflowagent.net).
PAYFLOWAGENT_TRUST_BASEBase URL of the Trust API (default https://trust.payflowagent.net).
X402_BUYER_RPCOptional payment RPC endpoint (Base mainnet by default).

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npmpayflowagent-mcp0.1.6

Tools

11

Saved tool list · updated 3w ago

ParameterTypeRequiredDescription
tokenstringYes

Details

From the project 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 [email protected]

Use it in Cursor

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

{
  "mcpServers": {
    "payflowagent": {
      "command": "npx",
      "args": ["-y", "[email protected]"],
      "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.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.