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

By [Specuverse](https://paragraph.com/@specuverse) · 2026-03-01

---

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](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
-----

*   Repo: [https://github.com/specuverse/mintclub-stakers-mcp](https://github.com/specuverse/mintclub-stakers-mcp)

---

*Originally published on [Specuverse](https://paragraph.com/@specuverse/mintclub-stakers-mcp)*