solana-devnet-faucet-mcp

MCP server for the Solana Devnet Faucet. It lets an MCP host or LLM check free-tier availability, request a devnet SOL claim, and check claim status.

The server talks only to https://solana-devnet-faucet.com.

What You Need

• Node.js 18.19+ (20+ recommended)
• A faucet agent API key: FAUCET_API_KEY — ask for it on on X
• A free-tier access code when calling claim_devnet_sol

Configure In An MCP Host

Use this in Cursor or any MCP host that supports stdio servers:

{
  "mcpServers": {
    "solana-devnet-faucet": {
      "command": "npx",
      "args": ["-y", "solana-devnet-faucet-mcp"],
      "env": {
        "FAUCET_API_KEY": "fsk_your_key_here"
      }
    }
  }
}

After saving the config, reload the MCP server or restart your MCP host.

Run From This Repo

If you are running the server locally from this repository:

pnpm install
cp .env.example .env
pnpm run build
pnpm run dev

Set FAUCET_API_KEY in .env before starting the server.

Tools

get_faucet_info

Returns current free-tier availability information.

Use this first to check whether the faucet is currently available.

claim_devnet_sol

Requests a free-tier devnet SOL claim.

Inputs:

• devnetAddress: Solana devnet wallet address
• devnetAmount: must be 0.2
• accessCode: free-tier access code

check_claim_status

Checks the status of a previous claim.

Inputs:

• id: the claimId returned by claim_devnet_sol (for example free:<uuid>)

Recommended LLM Flow

1. Call get_faucet_info.
2. If free-tier claims are available, call claim_devnet_sol with devnetAmount: 0.2.
3. If needed, poll check_claim_status with the returned claimId.

Notes

• The server requires FAUCET_API_KEY at startup and exits early if it is missing. Request a key on on X.
• For local terminal use, the server also reads .env from the current working directory.
• The faucet site is solana-devnet-faucet.com.