Solana MCP Wallet Agent API

A complete Express API for Solana blockchain wallet operations. This API provides functionality for managing Solana wallets, transferring SOL, and working with SPL tokens.

Features

• 🔐 Wallet Management: Create and manage Solana wallets
• 💰 SOL Transfers: Transfer SOL between wallets
• 🪙 Token Management: Create, mint, and transfer SPL tokens
• 📚 API Documentation: Interactive Swagger documentation
• 🔄 Error Handling: Robust error handling system
• 🧪 Development Ready: Easy to set up and use

Prerequisites

• Node.js (v16+)
• npm or yarn
• [Optional] Solana CLI tools for additional testing

Installation

1. Clone the repository:

git clone https://github.com/MindLayer25/Wallet-MCP-Agent.git
cd Wallet-MCP-Agent

2. Install dependencies:

npm install

3. Create a .env file in the root directory with the following contents:

PORT=3000
NODE_ENV=development
# Solana connection (devnet by default)
SOLANA_RPC_URL=https://api.devnet.solana.com
# For your wallet - get this from Solana keygen or a wallet export (JSON format)
WALLET_PRIVATE_KEY=

Development

Start the development server:

npm run dev

The server will start at http://localhost:3000 with hot-reloading enabled.

Build and Production

Build the project:

npm run build

Start the production server:

npm start

API Documentation

Once the server is running, access the Swagger documentation at:

http://localhost:3000/api-docs

The documentation provides a complete overview of all available endpoints with request/response examples.

API Endpoints

Wallet Endpoints

Method	Endpoint	Description
POST	/api/wallet	Create a new wallet
GET	/api/wallet/:publicKey	Get wallet information
POST	/api/wallet/transfer	Transfer SOL to another wallet

Token Endpoints

Method	Endpoint	Description
POST	/api/wallet/token	Create a new SPL token
POST	/api/wallet/token/mint	Mint tokens to an address
POST	/api/wallet/token/transfer	Transfer tokens to another wallet

Security Considerations

• IMPORTANT: This project uses environment variables for keys. In a production environment, you should use proper key management services.
• Never expose your private keys in client-side code.
• For production, consider implementing additional authentication and authorization mechanisms.

Solana Integrations

This API interacts with the Solana blockchain to:

1. Create and manage wallets
2. Transfer SOL between wallets
3. Create new SPL tokens
4. Mint tokens to addresses
5. Transfer tokens between wallets

Error Handling

The API includes comprehensive error handling with the following features:

• Detailed error messages in development mode
• Sanitized error messages in production
• Proper HTTP status codes
• Operational vs programming error distinction

Contributing

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add some amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

License

This project is licensed under the ISC License - see the LICENSE file for details.

Support

For support, please create an issue in the repository or contact the repository maintainers.