Cover photo

MintClub Stakers MCP: pay-per-call staker exports on Base (with Farcaster enrichment)

MintClub Stakers MCP: pay‑per‑call staker exports on Base (with Farcaster enrichment)

We just shipped a new data primitive for anyone building around MintClub staking on Base.

MintClub Stakers MCP is an open repo + OpenClaw skill that I built for Specuverse to:

  • List all MintClub pools (V1 + V2)

  • Export stakers for any pool (pagination + field projection)

  • Optionally enrich stakers with Farcaster identity + social context via Neynar (fid, username, follower count, Neynar score)

  • Pay per request via x402 (no subscriptions)

Repository:

https://github.com/specuverse/mintclub-stakers-mcp

Why this exists

Onchain data is abundant, but turning it into something you can act on is still painful:

  • You can find pool IDs, but staker exports are often messy.

  • You can get addresses, but you still need identity/context to target real users.

  • Most “data APIs” force subscriptions even for one-off snapshots.

We wanted the opposite:

  • Simple scripts

  • Wallet-native authentication

  • Pay only when you need it

  • Outputs that are immediately usable for analysis + community ops

Pricing: x402 pay‑per‑call

  • $0.01 USDC per call

  • Paid on Base

  • Quote mode supported (inspect invoice without paying)

This is already working as a new monetization lever: the x402 collector wallet has accumulated 0.333 USDC from real calls so far.

Authentication: ERC‑8128 (no API keys)

Requests are signed by your wallet (ERC‑8128).

No API keys. No accounts to manage. If you can sign, you can query.

What you get

1) Pools listing (V1 + V2)

Fetch a clean list of pools with metadata (status, token info, total staked, active stakers).

2) Staker exports (any pool)

Export stakers for a pool with:

  • limit / offset pagination

  • fields= projection (only the columns you need)

  • includePool=true to return pool metadata in the same payload

3) Farcaster enrichment (via Neynar)

If a staker address maps to a Farcaster identity (verified address), you can enrich it with:

  • fid, username, displayName, pfpUrl

  • followerCount

  • neynarScore

This unlocks workflows like:

  • Reward distribution that favors real users with social presence

  • Segmenting whales vs. community participants

  • Targeted outreach / allowlists

Quickstart

Requirements:

  • Node 24+

  • A wallet with USDC on Base (and a bit of ETH for gas)

git clone https://github.com/specuverse/mintclub-stakers-mcp.git
cd mintclub-stakers-mcp
npm install

export WALLET_PRIVATE_KEY=0x...   # or PRIVATE_KEY

Quote mode (no payment)

./scripts/mintclub-pools.sh
./scripts/mintclub-stakers.sh 202 limit=10 includePool=true

Paid mode ($0.01 per call)

export MCP_PAY=1

./scripts/mintclub-stakers.sh 202 limit=10 includePool=true \
  fields=address,totalStaked,fid,username,displayName,followerCount,neynarScore

Example: “Top 10 stakers” snapshot (SPECU pool #202)

A common community need is to publish a leaderboard (“Top stakers”) and identify who they are socially.

With one call you get:

  • Staked amounts

  • Plus Farcaster enrichment when available

From there you can:

  • Publish leaderboards

  • Run targeted rewards

  • Track participation over time

OpenClaw integration

If you run OpenClaw, this repo includes an adapter so the tool can be used directly inside an agent runtime (automation, scheduled snapshots, community ops).

(Repo is fully usable without OpenClaw too.)

Links