Skip to content
MCP Server Directory logo
developer-tools

Surfpool

Surfpool is where developers start their Solana journey.

Reviewed overview

MCP 服务器概览

What is Surfpool? Surfpool is a local-first developer environment and drop-in replacement for solana-test-validator that lets you work with real mainnet state without downloading the full chain. It provides Infrastructure as Code (IaC) for Solana, local and cloud tooling (Surfpool Studio / Surfpool Cloud), an IDL-to-SQL sync engine, and developer cheatcodes for safe experimentation.

How to use Surfpool?

  • Install: run the installer (curl -sL https://run.surfpool.run/ | bash), build from source (git clone …; cargo surfpool-install), or use the official Docker image (docker run surfpool/surfpool --version).
  • Run a local network: surfpool start
  • Docker example: docker run --rm -p 8899:8899 -p 8900:8900 -p 18488:18488 surfpool/surfpool
  • Inside an Anchor project Surfpool will generate IaC, deploy programs to the local network, and give a reproducible environment. Use surfpool --version and surfpool start --help for options.

Key features

  • Drop-in replacement for solana-test-validator that mirrors mainnet state without huge snapshots (runs on low-resource machines, even Raspberry Pi).
  • IDL-to-SQL: automatically map on-chain IDL to queryable SQL schema and sync to SQLite/Postgres for indexing and analytics.
  • Infrastructure as Code for Web3: declarative, auditable, and reproducible environment definitions inspired by Terraform.
  • Developer cheatcodes: simulate, debug, and replay transactions; Stream Oracles; Universal Faucet; Transaction Inspector; Time Travel.
  • Surfpool Studio (local dashboard) and Surfpool Cloud (serverless, scalable indexing and simulation).
  • Scenarios: curate slot-by-slot account states mixing live and overridden accounts to reproduce real-world conditions.
  • MCP (agentic features): built-in command palette integration to automate common setup tasks (e.g., spawn test users and funded accounts).

Use cases

  1. Local development and rapid iteration of Solana programs while mirroring mainnet state.
  2. Testing and debugging complex transactions and edge cases without touching mainnet.
  3. CI and reproducible staging environments that match production infrastructure.
  4. Indexing and analytics by syncing on-chain data to SQL for queries and reports.
  5. Stress-testing protocols and reproducing historical chain-state scenarios for audits and security reviews.

FAQ

  • Do I need to download a full mainnet snapshot? No. Surfpool mirrors mainnet state without requiring multi-terabyte snapshots and boots quickly.

  • Is Surfpool compatible with existing Solana tooling (solana-cli, Anchor)? Yes. Surfpool is designed to be a drop-in for existing workflows and has been tested with solana-cli, Anchor, and other tools.

  • Can I run Surfpool on low-end hardware or a Raspberry Pi? Yes. Surfpool is built to run on laptops and low-resource devices; it is offline-ready and local-first.

  • How do I run Surfpool in Docker and expose services? Use the official image and map ports, for example: docker run --rm -p 8899:8899 -p 8900:8900 -p 18488:18488 surfpool/surfpool. Set SURFPOOL_PUBLIC_HOST or SURFPOOL_PUBLIC_RPC_URL / WS / STUDIO env vars for external access.

  • What is Surfpool Cloud and Surfpool Studio? Surfpool Studio is the local dashboard to visualize and manage networks; Surfpool Cloud provides the same experience in the cloud for large-scale indexing and simulations (serverless backend).

  • How can I contribute or get help? Contributions are welcome via the GitHub repo (issues and PRs). Join the DevEx Telegram channel, the Surfpool Telegram and follow updates on X. Check the repository docs and open issues labeled help wanted for starter tasks.