pumpfun-mcp
A Model Context Protocol (MCP) server for interacting with the Pump.fun platform on Solana. This server enables AI assistants to create, buy, and sell tokens on the Pump.fun platform.
Usage
https://github.com/user-attachments/assets/0b0f1f6f-6ea6-4ca8-92a8-b4cc895814e4
To use this server with Claude or other MCP-compatible AI assistants, add the following configuration to your MCP client:
If you're on MacOS and want to run this in Claude Desktop, in your ~/Library/Application \Support/Claude/claude_desktop_config.json file, write the following:
{
"mcpServers": {
"pumpfun": {
"command": "node",
"args": ["/Users/noahsolomon/Desktop/pumpfun-mcp/build/index.js"], // note this should be YOUR absolute path to index.js, not mine.
"env": {
"HELIUS_RPC_URL": "https://your-helius-rpc-url.com"
}
}
}
}
Replace https://your-helius-rpc-url.com with your Helius RPC URL.
Installation
Clone this repository:
git clone https://github.com/noahgsolomon/pumpfun-mcp.git
cd pumpfun-mcp
Install dependencies:
npm install
Create a .env file with your Solana RPC URL:
HELIUS_RPC_URL=https://your-helius-rpc-url.com
You can get a free RPC URL from Helius.
To use an existing Solana wallet, add your private key to the .env file:
PRIVATE_KEY=your-base58-encoded-private-key
Then run the conversion script to create a keypair file:
node convert-key.js
This will create a default.json file in the .keys folder with your keypair.
Build the project:
npm run build
Run the MCP server:
node build/index.js
Components
Tools
get-token-info
- Get information about a Pump.fun token
- Input parameters:
tokenAddress (string, required): The token's mint address
create-token
- Create a new Pump.fun token
- Input parameters:
name (string, required): Token namesymbol (string, required): Token symboldescription (string, required): Token descriptionimageUrl (string, optional): Path to local image fileinitialBuyAmount (number, required): Initial buy amount in SOL (min 0.0001)accountName (string, optional): Name of the account to use (defaults to "default")
buy-token
- Buy a Pump.fun token
- Input parameters:
tokenAddress (string, required): The token's mint addressbuyAmount (number, required): Amount to buy in SOL (min 0.0001)accountName (string, optional): Name of the account to use (defaults to "default")slippageBasisPoints (number, optional): Slippage tolerance in basis points (defaults to 100)
sell-token
- Sell a Pump.fun token
- Input parameters:
tokenAddress (string, required): The token's mint addresssellAmount (number, required): Amount of tokens to sell (use 0 to sell all)accountName (string, optional): Name of the account to use (defaults to "default")slippageBasisPoints (number, optional): Slippage tolerance in basis points (defaults to 100)
list-accounts
- List all accounts in the keys folder
- No input parameters required
get-account-balance
- Get the SOL and token balances for an account
- Input parameters:
accountName (string, optional): Name of the account to check (defaults to "default")tokenAddress (string, optional): Token address to check balance for
Account Management
The MCP automatically creates and manages Solana keypairs in the .keys folder. Each keypair is stored as a JSON file with the account name as the filename.
When creating a token, the mint keypair is also saved in the .keys folder with the prefix mint-.
To use the MCP with your own account, you need to:
- Add your private key to the
.env file and run node convert-key.js
- Have sufficient SOL in that wallet
Standalone Scripts
The project includes several standalone scripts that can be run directly:
- Get Token Info :
node build/get-token-info.js <token_address>
- Create Token :
node build/create-token.js <name> <symbol> <description> <initial_buy_amount> [account_name] [image_url]
- Buy Token :
node build/buy-token.js <token_address> <buy_amount_sol> [account_name] [slippage_basis_points]
- Sell Token :
node build/sell-token.js <token_address> <sell_amount> [account_name] [slippage_basis_points]
- List Accounts :
node build/list-accounts.js
- Get Account Balance :
node build/get-token-balance.js <account_name> [token_address]
Important Notes
- Security : The keypairs are stored unencrypted in the
.keys folder. Make sure to secure this folder appropriately.
- Fees : All transactions on Solana require SOL for transaction fees. Make sure your accounts have enough SOL.
- Slippage : The default slippage tolerance is 1% (100 basis points). You can adjust this for each transaction.
- Images : When creating tokens with images, you must provide a local file path to the image. Remote URLs are not supported.
Development
Project Structure
src/index.ts: Main MCP server entry pointsrc/get-token-info.ts: Token information retrievalsrc/create-token.ts: Token creation functionalitysrc/buy-token.ts: Token buying functionalitysrc/sell-token.ts: Token selling functionalitysrc/list-accounts.ts: Account listing functionalitysrc/get-token-balance.ts: Account balance checkingsrc/utils.ts: Shared utility functionsconvert-key.js: Utility to convert a base58 private key to a keypair JSON file
Building
npm run build
