Raydium LaunchLab MCP

1# Raydium LaunchLab MCP
2 
3An MCP server that enables AI agents to launch, buy, and sell tokens on the Raydium Launchpad(also know as [LaunchLab](https://raydium.io/launchpad/)).
4 
5![License](https://img.shields.io/badge/license-MIT-blue.svg)
6![Node.js](https://img.shields.io/badge/Node.js-18.x-green.svg)
7![Status](https://img.shields.io/badge/status-active-brightgreen.svg)
8 
9## Features
10 
11- **Mint Token**: Create a bonding-curve-based token with customizable parameters (name, symbol, decimals, total supply, fundraising target, etc.) and upload metadata to IPFS.
12- **Buy Token**: Purchase tokens from a Raydium Launchpad pool using SOL.
13- **Sell Token**: Sell tokens back to a Raydium Launchpad pool.
14- **IPFS Integration**: Uploads token images and metadata to IPFS for decentralized storage.
15 
16## Prerequisites
17 
18- **Node.js**: Version 18.x or higher.
19- **Solana Wallet**: A private key with sufficient SOL for transactions.
20- **Pinata Account**: API credentials for IPFS storage (JWT and gateway).
21 
22## Installation
23 
241. **Clone the Repository**:
25   ```bash
26   git clone https://github.com/kukapay/raydium-launchlab-mcp.git
27   cd raydium-launchlab-mcp
28   ```
29 
302. **Install Dependencies**:
31   ```bash
32   npm install
33   ```
34   
353. **Configure MCP Client**:
36    ```json
37    {
38      "mcpServers": {
39        "raydium-launchlab": {
40          "command": "node",
41          "args": ["/path/to/raydium-launchlab-mcp/index.js"],
42          "env": {
43             "RPC_URL": "your-solana-rpc-url",
44             "PRIVATE_KEY": "your-private-key-as-integer-array",
45             "PINATA_JWT": "your-pinata-jwt",
46             "PINATA_GATEWAY": "your-pinata-gateway"
47          }
48        }
49      }
50    }
51    ```
52   - Replace `/path/to/raydium-launchlab-mcp` with your actual installation path.  
53   - Replace `your-solana-rpc-url` with your own Solana rpc url.
54   - Replace `your-private-key-as-integer-array` with your Solana wallet's private key (e.g., `[1,2,3,...]`).
55   - Obtain `PINATA_JWT` and `PINATA_GATEWAY` from your Pinata account.
56   
57 
58## Tools
59 
60The MCP server exposes three tools for interacting with Raydium Launchpad:
61 
62### 1. `mint_token`
63Creates a bonding-curve-based token on Raydium Launchpad with metadata uploaded to Pinata IPFS.
64 
65**Parameters**:
66- `name` (string, 1-32 chars): Token name (e.g., "My Token").
67- `symbol` (string, 1-10 chars): Token symbol (e.g., "MTK").
68- `imagePath` (string): Path to the token logo (e.g., "/assets/logo.png").
69- `decimals` (integer, 0-18, default: 6): Number of decimal places.
70- `fundRaisingTarget` (number, positive, default: 85): Target SOL amount to raise.
71- `totalSupply` (number, default: 1,000,000,000): Total token supply.
72- `totalSellPercent` (number, default: 0.75): Percentage of supply for fundraising.
73- `createOnly` (boolean, default: true): If `true`, skips initial buy.
74- `initialBuyAmount` (number, non-negative, default: 0.1): SOL amount for initial buy (if `createOnly` is `false`).
75- `slippage` (number, 0-1.0, default: 0.01): Acceptable price slippage percentage (e.g., 0.01 for 1%).
76 
77**Example Prompt**:
78> Create a new token on Raydium Launchpad named 'My Token' with symbol 'MTK', using the logo at '/assets/logo.png', a fundraising target of 35 SOL.
79 
80 
81**Example Response**:
82> Successfully created token (mint: <mint_address>, name: My Token, symbol: MTK). Transaction signatures: <tx_id>
83 
84### 2. `buy_token`
85Purchases tokens from a Raydium Launchpad pool using SOL.
86 
87**Parameters**:
88- `mintAddress` (string): Token mint address.
89- `inAmount` (number, positive): Amount of SOL to spend.
90- `slippage` (number, 0-1.0, default: 0.01): Acceptable price slippage percentage.
91 
92**Example Prompt**:
93> Buy tokens from a Raydium Launchpad pool with mint address '<mint_address>' using 0.5 SOL and a slippage of 1%.
94 
95**Example Response**:
96> Successfully purchased tokens (mint: <mint_address>). Transaction signature: <tx_id>
97 
98### 3. `sell_token`
99Sells tokens back to a Raydium Launchpad pool.
100 
101**Parameters**:
102- `mintAddress` (string): Token mint address.
103- `inAmount` (number, positive): Amount of tokens to sell.
104- `slippage` (number, 0-1.0, default: 0.01): Acceptable price slippage percentage.
105 
106**Example Prompt**:
107> Sell 1,000,000 tokens from a Raydium Launchpad pool with mint address '<mint_address>' and a slippage of 1%.
108 
109**Example Response**:
110> Successfully sold tokens (mint: <mint_address>). Transaction signature: <tx_id>
111 
112## License
113 
114This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.
115 
116