payflowagent-mcp

PayFlowAgent MCP

MCP-Server (stdio) fuer Cursor, Claude Desktop und eigene Agenten. Ruft die PayFlowAgent-Suite ab; bezahlte Tools loesen x402-Zahlungen (USDC auf Base) aus.

MCP Registry: io.github.Coinlooter/mcp · npm: payflowagent-mcp@0.1.7

Suite-Katalog: https://payflowagent.net/catalog.json

Updates: Bluesky · Telegram

Tools — nad.fun

Tool	Kosten	Beschreibung
score_token	kostenlos	Score, RiskLevel, Action (+ Upsell)
decide_token	x402	Voller Entscheidungs-Report
token_summary	x402	Graduation + Momentum
screen_tokens	x402	Gerankte Token-Liste

Tools — Datafeed

Tool	Kosten	Beschreibung
sample_yields	kostenlos	Top-Pools + Opportunity-Vorschau
yield_opportunities	x402	Gerankte Yield-Chancen mit Score & reasons

Tools — Enrich

Tool	Kosten	Beschreibung
sample_enrich	kostenlos	Sample-Suchform + Upsell (keine Upstream-Keys)
web_search	x402	Live Google-SERP (Serper)
scrape_url	x402	URL → Markdown/Text (Firecrawl)

Tools — Trust

Tool	Kosten	Beschreibung
check_wallet_lite	kostenlos	Verdict + Score fuer Base-Adresse
check_wallet	x402	Reasons + canPay (USDC/ETH)

Env

Variable	Pflicht	Beschreibung
PAYFLOWAGENT_API_BASE	nein	nad.fun API (Default https://nad.payflowagent.net)
PAYFLOWAGENT_DATAFEED_BASE	nein	Datafeed API (Default https://data.payflowagent.net)
PAYFLOWAGENT_ENRICH_BASE	nein	Enrich API (Default https://enrich.payflowagent.net)
PAYFLOWAGENT_TRUST_BASE	nein	Trust API (Default https://trust.payflowagent.net)
X402_BUYER_PRIVATE_KEY	nein*	Zahler-Wallet fuer bezahlte Tools
X402_BUYER_RPC	nein	Zahlungs-RPC (Default Base Mainnet)

* Ohne Private Key funktionieren nur kostenlose Tools (score_token, sample_yields, sample_enrich, check_wallet_lite).

Cursor / Claude (Copy-Paste)

{
  "mcpServers": {
    "payflowagent": {
      "command": "npx",
      "args": ["-y", "payflowagent-mcp"],
      "env": {
        "PAYFLOWAGENT_API_BASE": "https://nad.payflowagent.net",
        "PAYFLOWAGENT_DATAFEED_BASE": "https://data.payflowagent.net",
        "PAYFLOWAGENT_ENRICH_BASE": "https://enrich.payflowagent.net",
        "PAYFLOWAGENT_TRUST_BASE": "https://trust.payflowagent.net"
      }
    }
  }
}

Mit Zahlungen: X402_BUYER_PRIVATE_KEY in env ergaenzen (dedizierte Wallet mit USDC auf Base).

Entwicklung (im Monorepo)

pnpm --filter payflowagent-mcp typecheck
pnpm --filter payflowagent-mcp build

Veroeffentlichung (npm / MCP Registry)

Nur aus diesem Ordner (apps/mcp/), nicht aus dem Monorepo-Root:

cd apps/mcp
pnpm build
npm publish
mcp-publisher login github   # falls JWT abgelaufen
mcp-publisher publish