Solafon

Provides a unified MCP server that exposes Bot API and Wallet API tools for Solafon, enabling interactive bot and wallet actions through MCP clients.

javascript

0

GitHub Stars

javascript

Language

1 month ago

First Indexed

3 weeks ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "solanafon-solafon-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "solafon-mcp"
      ],
      "env": {
        "SOLAFON_API_URL": "https://api.solafon.com",
        "SOLAFON_BOT_TOKEN": "your-bot-api-key-here"
      }
    }
  }
}

You can run the Solafon MCP server to enable natural language powered interactions with your Solana wallet and bot on Solafon. Connect it to MCP clients like Claude Desktop, Cursor, or VS Code to build and manage Solafon mini-apps through simple prompts and actions.

How to use

You will use a compatible MCP client to connect to the Solafon MCP server. Once connected, you can perform actions such as querying bot information, sending messages to bot conversations, managing webhooks and greeting messages, and interacting with wallet data. You can issue prompts to perform wallet lookups, transaction simulations, or balance checks, and you can combine bot operations with wallet queries to build interactive experiences.

How to install

Prerequisites: ensure you have Node.js version 18 or higher installed on your system.

Start the MCP server locally using the runtime command shown in the configuration examples. You must supply your bot token as an environment variable named SOLAFON_BOT_TOKEN.

SOLAFON_BOT_TOKEN=your-bot-api-key-here npx -y solafon-mcp

Additional notes

Environment variable usage: SOLAFON_BOT_TOKEN is required to authenticate your bot with the Solafon platform. An optional SOLAFON_API_URL can be set to specify a custom API base URL; if not provided, the default public API URL is used.

Security and usage notes

Keep your SOLAFON_BOT_TOKEN secure and do not share it in public code or logs. Regularly rotate tokens and use per-project tokens where possible. When connecting through MCP clients, ensure you are using trusted tools and verified configurations to prevent unintended access to bot or wallet data.

Available tools

get_bot_info

Retrieve information about your bot, including its app details.

send_message

Send text, images, buttons, and carousels to conversations.

edit_message

Edit a message that was previously sent by the bot.

delete_message

Remove a message from a conversation.

list_conversations

List all conversations associated with your bot.

get_conversation_messages

Read messages within a specific conversation.

get_user

Fetch information about a user.

set_webhook

Configure the webhook URL for callbacks.

set_welcome_message

Set the greeting message shown to new users.

get_wallet_balance

Query SOL and token balances with USD values.

get_token_list

List supported tokens with metadata.

get_token_prices

Get current USD prices for tokens.

get_transaction_history

Retrieve wallet transaction history.

get_transaction_status

Check the confirmation status of a transaction.

get_latest_blockhash

Obtain the latest blockhash for transactions.

send_transaction

Broadcast a signed transaction to the network.

simulate_transaction

Simulate a transaction before broadcasting.