Toleno Network

Toleno Network MCP Server lets you control your Toleno mining account directly from Claude AI using natural language. You can check balances, start mining, claim rewards, and view referrals without leaving your chat interface, making it easier to manage Toleno activities on the fly.

How to use

To use this MCP server, integrate it with your MCP client and run the server commands exactly as shown. You will configure an MCP server entry that runs the Toleno MCP package via npx and provides your Toleno API key to enable actions such as checking balances, starting mining sessions, claiming rewards, and viewing referrals. The client will expose function calls like getting global stats, getting your profile, starting mining, and more. Use the available endpoints through your MCP client to perform these actions in natural language conversations.

How to install

Prerequisites: ensure you have Node.js 18 or higher installed on your system. You will also need npm or npx to run the MCP server setup and commands.

# Quick setup using a guided installer
npx mcp_toleno setup

# Or non-interactive setup with your API key
npx mcp_toleno setup --key tlno_your_key_here

Configuration and usage notes

Configure the Toleno MCP server in your Claude Desktop or your project root so the MCP client can invoke the server. The following example shows how to specify the server in a local project setup and in Claude Code, using an environment variable to supply your Toleno API key.

{
  "mcpServers": {
    "Toleno Network": {
      "command": "npx",
      "args": ["-y", "mcp_toleno"],
      "env": {
        "TOLENO_API_KEY": "tlno_paste_your_key_here"
      }
    }
  }
}

Manual setup for Claude Desktop and Claude Code

Use the following configurations exactly as shown to enable the MCP server in Claude Desktop and in your project root. This passes the Toleno API key to the MCP runner and allows you to issue natural language commands for Toleno operations.

// Claude Desktop
{
  "mcpServers": {
    "Toleno Network": {
      "command": "npx",
      "args": ["-y", "mcp_toleno"],
      "env": {
        "TOLENO_API_KEY": "tlno_paste_your_key_here"
      }
    }
  }
}

// Claude Code
{
  "mcpServers": {
    "Toleno Network": {
      "command": "npx",
      "args": ["-y", "mcp_toleno"],
      "env": {
        "TOLENO_API_KEY": "tlno_paste_your_key_here"
      }
    }
  }
}

What you can run with Claude

You can access the Toleno MCP features from Claude using natural language prompts. For example, you can ask Claude to show your mining status, start a new mining session, claim rewards, or retrieve balance and wallet information. The tools available through this MCP server include operations to fetch global stats, your profile, mining status, start mining, claim rewards, wallet info, and referrals.

Security and keys

Your Toleno API key is stored locally in the Claude config file and is never sent to external Toleno servers by Claude. Revoke it anytime from the Toleno app if needed.

Troubleshooting

If the Toleno MCP tools do not appear in Claude Desktop, completely quit and restart Claude Desktop after finishing setup. Look for the hammer icon in the chat toolbar to access the tools.

Notes and requirements

You will need Node.js 18 or higher to run the MCP server locally. If you encounter a message saying the API key is not configured, run the setup command again or manually add the key to your config file.

Available tools

get_global_stats

Retrieve total tokens mined and platform-wide user count.

get_profile

Retrieve your balance, mining power, streak, and level.

get_mining_status

Check active mining session, time remaining, and tokens earned.

start_mining

Start a new 24-hour mining session.

claim_mining_rewards

Claim tokens from a completed mining session.

get_wallet_info

Get wallet address, withdrawable balance, and limits.

get_referral_info

Retrieve referral code, team size, and active referrals.