Run an agent and toolkit in a temporary Meshagent Room. The MCP Server and chatbot will automatically shut down when the Room is closed.

Required Environment Variables

  • ARMOR_API_URL (e.g. https://app.armorwallet.ai/api/v1)
  • ARMOR_API_KEY (<PUT-YOUR-KEY-HERE>)

Steps

  1. Install Meshagent
    pip install "meshagent[all]"
    
  2. Sign Up & Authenticate
    Follow the guide at:
    https://docs.meshagent.com/cli/getting_started
  3. Launch the MCP Server in a Meshagent Room
    meshagent service test --room=test --role=agent --image=meshagent/mcp-armor-crypto:latest \
      --env MESHAGENT_PORT=8001 \
      --env ARMOR_API_URL=https://app.armorwallet.ai/api/v1 \
      --env ARMOR_API_KEY=<PUT-YOUR-KEY-HERE> \
      --port="num=8001 path=/webhook liveness=/ type=meshagent.callable" \
      --name=mcp-armor-crypto-service-test
    
    • This command starts a Meshagent Room called test with the MCP Armor Crypto server running as a cloud agent.
    • Note: The Room and all running services will be auto-removed when inactive.
  4. Join a Chatbot to the Room with the MCP Toolkit
    meshagent chatbot join --room=test --agent-name=mcp-armor-crypto --name=mcp-armor-crypto --toolkit=mcp-armor-crypto
    
    • Launches a chatbot within the same Room, capable of using the Armor Crypto MCP tools.
    • Multiple toolkits can be loaded into the same Room for multi-tool conversations.
    • You’ll receive a Room link in the output.
  5. Try Out the Tools
    Open the provided Room link in your browser and message the agent to interact with MCP server tools.

Project-Level Deployment (Persistent Tooling in All Rooms)

For production or group onboarding, deploy services at the Meshagent project level. These agents will automatically join all Rooms created under your Meshagent project—no need for repeated local launches.

Deploy the MCP Server Agent

meshagent service create --role=agent --image=meshagent/mcp-armor-crypto:latest \
  --env MESHAGENT_PORT=8001 \
  --env ARMOR_API_URL=https://app.armorwallet.ai/api/v1 \
  --env ARMOR_API_KEY=<PUT-YOUR-KEY-HERE> \
  --port="num=8001 path=/webhook liveness=/ type=meshagent.callable" \
  --name=mcp-armor-crypto-service

Deploy a Persistent Chatbot Using the MCP Toolkit

meshagent service create --image="meshagent/cli:latest" \
  --port="num=9001 path=/agent liveness=/ type=meshagent.callable participant_name=mcp-armor-crypto-chatbot" \
  --env="MESHAGENT_PORT=9001" \
  --name="mcp-armor-crypto-chatbot-service" \
  --command="meshagent chatbot service --agent-name=mcp-armor-crypto-chatbot --toolkit=mcp-armor-crypto"
  • On any new Room creation, the MCP Server and its bot will automatically appear, ready to use.

Tools Available

The MCP server provides a rich set of blockchain, wallet, and trading tools directly to agents and chatbots in Meshagent Rooms.

Summary of Tools

ToolDescription
add_wallets_to_groupAdd wallets to a specified group.
archive_wallet_groupArchive wallet groups.
archive_walletsArchive wallets.
calculate_token_conversionPerform token conversion quote between two tokens.
calculatorSafely evaluates a mathematical/statistical expression using Python syntax.
cancel_dca_orderCancel a DCA order.
cancel_orderCancel a limit or stop loss order.
create_dca_orderCreate a DCA order.
create_groupsCreate new wallet groups.
create_orderCreate an order.
create_walletCreate new wallets.
get_all_ordersRetrieve all limit and stop loss orders.
get_all_walletsRetrieve all wallets with balances.
get_armor_mcp_versionGet the current Armor Wallet version.
get_current_timeGets the current time and date.
get_stake_balancesGet the balance of staked SOL (jupSOL).
get_token_candle_dataGet candle data about any token for analysis.
get_top_trending_tokensGet the top trending tokens in a timeframe.
get_wallet_token_balanceGet the balance for a list of wallet/token pairs.
list_dca_ordersList all DCA orders.
list_groupsList all wallet groups.
list_single_groupRetrieve details for a single wallet group.
remove_wallets_from_groupRemove wallets from a specified group.
rename_walletsRename wallets.
search_official_token_addressGet official token address/symbol for given token.
search_token_detailsSearch and retrieve token details.
send_key_to_telegramSend the mnemonic or private key to telegram.
stake_quoteRetrieve a stake quote.
stake_transactionExecute a stake transaction.
swap_quoteRetrieve a swap quote.
swap_transactionExecute a swap transaction.
transfer_tokensTransfer tokens from one wallet to another.
unarchive_wallet_groupUnarchive wallet groups.
unarchive_walletsUnarchive wallets.
unstake_quoteRetrieve an unstake quote.
unstake_transactionExecute an unstake transaction.
wait_a_momentWait for a short amount of time (up to 10 seconds).

Tools Details


MCP Armor Crypto Docker Usage

To run the server standalone via Docker:
{
  "mcpServers": {
    "armor-crypto": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "ARMOR_API_URL",
        "-e",
        "ARMOR_API_KEY",
        "mcp/armor-crypto"
      ],
      "env": {
        "ARMOR_API_URL": "https://app.armorwallet.ai/api/v1",
        "ARMOR_API_KEY": "<PUT-YOUR-KEY-HERE>"
      }
    }
  }
}
Why is it safer to run MCP Servers with Docker?