Airdrop Checker X402

by Br0ski777

266 downloads
Not rated
GitHub

About

Check wallet eligibility for active crypto airdrops -- token, value, deadline, claim URL via Etherscan. -- x402 micropayment API + MCP server for AI agents

Details

Author
Br0ski777
Downloads
266
Categories
Other, API

- Pay-per-call via x402 (USDC on Base L2, no signup)
- No API key or rate‑limit walls
- Returns eligible airdrops with token name, value, and claim URL
- Supports any Ethereum wallet address (0x...)
- Integrates with MCP clients and x402-aware HTTP clients

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Airdrop Checker X402
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Add the server to your MCP client config (e.g., Claude Desktop, Cursor, ElizaOS) with the URL https://airdrop-checker.api.klymax402.com/mcp. Alternatively, call the HTTP endpoint directly with a wallet address; any x402-aware client automatically handles the 402 payment challenge. Use the tool crypto_check_airdrops with parameter address (Ethereum wallet).

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "airdrop checker x402": {
            "airdrop-checker": {
                "url": "https://airdrop-checker-production.up.railway.app/mcp",
                "transport": "sse"
            }
        }
    }
}

McpServers

{
    "airdrop-checker": {
        "url": "https://airdrop-checker-production.up.railway.app/mcp",
        "transport": "sse"
    }
}

Airdrop Checker API

MCP Server
x402
License: MIT

Check wallet eligibility for active crypto airdrops -- token, value, deadline, claim URL via Etherscan. Pay-per-call via x402 (USDC on Base L2) -- no API key, no signup, no rate-limit wall.

Part of the klymax402 marketplace -- 100 x402 micropayment APIs for AI agents, one wallet, USDC on Base.

Quickstart -- MCP

Add to your MCP client config (Claude Desktop, Cursor, ElizaOS, etc.):

{
  "mcpServers": {
    "airdrop-checker": {
      "url": "https://airdrop-checker.api.klymax402.com/mcp"
    }
  }
}

Quickstart -- HTTP (x402)

curl "https://airdrop-checker.api.klymax402.com/api/check?address=0x0000000000000000000000000000000000dEaD"

-> 402 Payment Required, with an x402 payment challenge in the response body

Any x402-aware client (@x402/fetch, x402-agent-tools, ATXP) handles the 402 -> sign -> retry cycle automatically.

Tools

| Tool | Method | Path | Price | Description |
|---|---|---|---|---|
| crypto_check_airdrops | GET | /api/check | $0.005 | Check wallet eligibility for crypto airdrops |

crypto_check_airdrops

Use this when you need to check if a wallet address is eligible for crypto airdrops. Scans wallet interactions against known airdrop contracts and returns eligible claims.

Parameters

| Name | Type | Required | Description |
|---|---|---|---|
| address | string | yes | Ethereum wallet address (0x...) |

Returns

- eligible -- array of airdrops the wallet qualifies for
- totalEligible -- number of eligible airdrops found
- totalEstimatedValue -- combined estimated USD value of all eligible airdrops
- walletAddress -- the address checked
- checkedAt -- timestamp of the check

Example response:

{"eligible":[{"tokenName":"LayerZero","tokenSymbol":"ZRO","estimatedValueUsd":450,"deadline":"2026-06-30T00:00:00Z","claimUrl":"https://claim.layerzero.network","status":"claimable"}],"totalEligible":3,"totalEstimatedValue":1250,"walletAddress":"0x742d...","checkedAt":"2026-04-13T12:00:00Z"}

When to use: discovering unclaimed airdrops, monitoring multiple wallets for eligibility, or building airdrop farming dashboards.

Example agent prompts

- "Check if a wallet address is eligible for crypto airdrops"

Payment

- Protocol: x402 -- HTTP-native pay-per-call, no signup, no API key
- Network: Base L2 (eip155:8453)
- Asset: USDC
- Facilitator: Coinbase CDP (primary), PayAI (fallback)

Part of klymax402

100 x402 micropayment APIs for AI agents -- one wallet, USDC on Base, zero signup.

- Catalog: https://klymax402.com/llms.txt
- Full API reference: https://klymax402.com/llms-full.txt
- Live stats: https://klymax402.com/stats

License

MIT

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.