marinade-finance

This Marinade Finance MCP Server provides a focused set of tools to interact with Marinade Finance on the Solana network. It exposes capabilities to query the official Marinade Finance documentation, retrieve the protocol state, manage liquid staking operations (stake and unstake mSOL), check mSOL balances, and transfer mSOL between wallets. Users can call: get_marinade_state to understand current protocol conditions, search_documentation to fetch relevant Marinade docs and examples, get_msol_balance to verify holdings, stake_msol and unstake_msol to manage staking positions, and send_msol to transfer tokens to another wallet. The server uses a Smithery-auth flow and is designed to run in either standard input (stdio) or streamable-http mode depending on configuration. Before use, ensure your environment variables (private key, RPC URLs, environment, and port settings) are properly configured to enable on-chain operations and network access.

Prerequisites:

• Node.js and npm/yarn/pnpm installed on your system
• Access to a Solana wallet private key (Base58) for on-chain actions
• Network access to Solana RPC endpoints (MAINNET or DEVNET)

Installation steps:

1. Install PNPM (optional but recommended): curl -fsSL https://get.pnpm.io/install.sh | sh

2. Install dependencies and set up the project (from the repository root): git clone <repository-url> cd marinade-finance-mcp-server pnpm install

3. Configure environment variables (see .env Config in README):

   • Create a .env file or set them in your hosting environment: PRIVATE_KEY= SOLANA_RPC_URL= SOLANA_RPC_URL_DEVNET= ENVIRONMENT=MAINNET|TESTNET USE_STREAMABLE_HTTP=true|false PORT=3000 HOST=0.0.0.0

4. Build and run the server (example in http/stdio mode): pnpm run build pnpm run start

Notes:

• The Run command shown in the README uses pnpx and tsx to launch the TS entry point in stdio mode. The MCP config below mirrors that approach via an npx-based command invocation.

Tips and common issues:

• Ensure PRIVATE_KEY is valid and has permissions for on-chain staking/unstaking/transfers.
• If USING_STREAMABLE_HTTP is true, ensure PORT and HOST are accessible by clients and firewalls.
• For TESTNET workflows, set SOLANA_RPC_URL_DEVNET and ENVIRONMENT accordingly.
• If you encounter authentication/setup issues with Smithery, re-run the publish flow on smithery.ai and re-point the server URL in your MCP host config.
• When deploying, confirm that environment variables are loaded in the hosting environment (e.g., GitHub Secrets, cloud runner, or container env).
• Balance and stake operations depend on network consensus and wallet state; always verify balances with get_msol_balance before initiating transfers.