solafon-mcp

Model Context Protocol server for building bots and interacting with Solana wallet on the Solafon 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:

{
  "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:

{
  "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:

{
  "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
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

License

MIT