Plasma

This Production-ready MCP server lets you automate and orchestrate Plasma Testnet operations. It exposes a flexible API and tools to manage XPL transfers, gas estimation, network status, and smart contract interactions, enabling seamless integration with AI assistants and automated workflows.

How to use

Connect your MCP client to the Plasma Testnet server to perform blockchain operations through natural language prompts or automated scripts. You can run the MCP server locally for development or deploy it in containerized environments for production. The server supports both stdio-based local execution and HTTP endpoints, allowing you to interact with it from AI assistants and your own tooling.

How to install

Prerequisites: ensure you have Node.js and npm installed on your machine.

Install and run the MCP server using the following steps.

bash
# Clone the Plasma MCP project
git clone https://github.com/tairon-ai/plasma-mcp.git
cd plasma-mcp

# Install dependencies
npm install

# Configure environment
cp .env.example .env
# Edit .env with your configuration

# Start the server
npm start

# Development mode
npm run dev

# MCP stdio server for Claude Desktop
npm run mcp

Configuration and runtime notes

The server supports environment-based configuration. You will typically set your RPC URL and wallet key to enable on-chain transactions and reads. For local development with Claude Desktop integration, you can run a local stdio server that points to your MPC entry script.

{
  "mcpServers": {
    "plasma_network": {
      "command": "node",
      "args": ["/path/to/plasma-mcp/mcp/index.js"],
      "env": {
        "RPC_URL": "https://testnet-rpc.plasma.to",
        "WALLET_PRIVATE_KEY": "your_private_key_without_0x"
      }
    }
  }
}

Deployment and runtime options

You can deploy the server using Docker in a containerized setup or run it directly on your host. Build and run in production, or use Docker for consistent environments.

# Production build and start
npm run build
NODE_ENV=production npm start

# With PM2
pm2 start server.js --name plasma-mcp

# With Docker
docker build -t plasma-mcp .
docker run -d -p 8080:8080 --env-file .env plasma-mcp

Available tools

getServiceInfo

Get server capabilities and configuration details

getNetworkInfo

Retrieve current Plasma network information including status and block height

getAccountBalance

Fetch the XPL balance for a given address

sendTransaction

Send a custom transaction with to, value, data, gasLimit, gasPrice parameters

sendXPL

Send XPL tokens to a specified address

getTransactionStatus

Check the status of a transaction by its hash

requestFaucet

Obtain testnet faucet information for a specific address

estimateGas

Estimate gas usage for a given transaction configuration

getLatestBlocks

Retrieve the most recent blocks from the network

getGasPrice

Query the current gas price on the network

getTokenInfo

Get details about a token given its contract address

getWalletBalances

Get token balances for a wallet and specified tokens