# solafon-mcp
Model Context Protocol server for building bots and interacting with Solana wallet on the [Solafon](https://solafon.com) platform.
Connect this MCP server to **Claude Desktop**, **Cursor**, **VS Code**, or any MCP-compatible AI tool to build Solafon mini-apps using natural language.
## Quick Start
### Claude Desktop
Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
```json
{
"mcpServers": {
"solafon": {
"command": "npx",
"args": ["-y", "solafon-mcp"],
"env": {
"SOLAFON_BOT_TOKEN": "your-bot-api-key-here"
}
}
}
}
```
### Cursor
Add to `.cursor/mcp.json` in your project:
```json
{
"mcpServers": {
"solafon": {
"command": "npx",
"args": ["-y", "solafon-mcp"],
"env": {
"SOLAFON_BOT_TOKEN": "your-bot-api-key-here"
}
}
}
}
```
### VS Code
Add to your VS Code MCP settings:
```json
{
"mcp": {
"servers": {
"solafon": {
"command": "npx",
"args": ["-y", "solafon-mcp"],
"env": {
"SOLAFON_BOT_TOKEN": "your-bot-api-key-here"
}
}
}
}
}
```
## Requirements
- **Node.js 18+** (no other dependencies needed)
## Available Tools
### Bot API
| Tool | Description |
|------|-------------|
| `get_bot_info` | Get your bot's app info |
| `send_message` | Send text, images, buttons, carousels |
| `edit_message` | Edit a previously sent message |
| `delete_message` | Delete a message |
| `list_conversations` | List all bot conversations |
| `get_conversation_messages` | Read messages in a conversation |
| `get_user` | Get user info |
| `set_webhook` | Configure webhook URL |
| `set_welcome_message` | Set greeting for new users |
### Wallet API
| Tool | Description |
|------|-------------|
| `get_wallet_balance` | SOL + token balances with USD values |
| `get_token_list` | Supported tokens with metadata |
| `get_token_prices` | Current USD prices |
| `get_transaction_history` | Wallet transaction history |
| `get_transaction_status` | Check transaction confirmation |
| `get_latest_blockhash` | Get blockhash for transactions |
| `send_transaction` | Broadcast signed transaction |
| `simulate_transaction` | Simulate before sending |
## Prompts (Templates)
| Prompt | Description |
|--------|-------------|
| `create_echo_bot` | Step-by-step echo bot guide |
| `create_wallet_checker_bot` | Bot that checks wallet balances |
| `create_interactive_menu_bot` | Bot with button menus and callbacks |
## Environment Variables
| Variable | Required | Default | Description |
|----------|----------|---------|-------------|
| `SOLAFON_BOT_TOKEN` | Yes | — | Bot API token from developer portal |
| `SOLAFON_API_URL` | No | `https://api.solafon.com` | API base URL |
## Getting a Bot Token
1. Register at [Solafon](https://solafon.com)
2. Go to Developer Portal
3. Create a new app
4. Copy the API key shown after creation
## Example Usage with Claude
After connecting the MCP server, you can say to Claude:
> "Check the SOL balance of wallet address 7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU"
> "Send a welcome message to conversation abc-123 with two buttons: Check Balance and Help"
> "Set up my bot's webhook to https://myserver.com/webhook"
> "Show me the last 10 transactions for this wallet"
## Documentation
Full documentation: [docs.solafon.com](https://docs.solafon.com)
## License
MIT
