mcp_toleno

Toleno Network MCP Server — Control your Toleno mining account directly from Claude AI using natural language.

Check balance · Start mining · Claim rewards · View referrals — all without opening the app.

Quick Start

npx mcp_toleno setup

The setup wizard will:

Ask for your Toleno API key
Validate it against the Toleno API
Automatically update your Claude Desktop config
Remind you to restart Claude Desktop

Or non-interactive:

npx mcp_toleno setup --key tlno_your_key_here

Get Your API Key

Open the Toleno app on your phone
Go to Settings → API Keys
Tap "Create New Key"
Name it (e.g. Claude Desktop)
Copy it immediately — starts with tlno_, shown only once

Manual Setup

Claude Desktop

OS	Config file
Windows	`%APPDATA%\Claude\claude_desktop_config.json`
macOS	`~/Library/Application Support/Claude/claude_desktop_config.json`
Linux	`~/.config/Claude/claude_desktop_config.json`

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

Claude Code

Add .mcp.json to your project root:

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

Available Tools

Tool	What it does	Needs key?
`get_global_stats`	Total tokens mined, platform-wide user count	No
`get_profile`	Your balance, mining power, streak, level	Yes
`get_mining_status`	Active session, time remaining, tokens earned	Yes
`start_mining`	Start a new 24-hour mining session	Yes
`claim_mining_rewards`	Claim tokens from a completed session	Yes
`get_wallet_info`	Wallet address, withdrawable balance, limits	Yes
`get_referral_info`	Referral code, team size, active referrals	Yes

What You Can Ask Claude

"What is my Toleno mining status?"
"Start mining"
"Claim my rewards"
"How many TOL tokens do I have?"
"Show my wallet info"
"How many referrals do I have?"
"What are the global Toleno stats?"
"Do I have any claimable rewards?"
"When does my mining session end?"

Example Session

You:    What is my mining status?

Claude: Your mining session is active!
        ⛏  Started: 3 hours ago
        ⏱  Time remaining: 21 hours
        💰 Earned so far: 3.5 / 28 TOL
        ✅ Keep it running to earn the full reward!

---

You:    Claim my rewards

Claude: Claiming your mining rewards now...
        ✅ Successfully claimed 28 TOL!
           New balance: 1,596 TOL

---

You:    How many referrals do I have?

Claude: Your referral stats:
        👥 Total referrals: 12
        ✅ Active today: 7
        🔗 Your code: TOLENO-ABC123

FAQ

Q: Is my API key safe? Your key is stored locally in the Claude config file — never sent to Claude's servers. Revoke it anytime from the Toleno app.

Q: Can Claude do anything harmful to my account? No. Claude can read data and trigger mining/claim actions only. It cannot change your wallet address, withdraw tokens, or delete your account.

Q: The tools don't appear in Claude Desktop. Fully quit and restart Claude Desktop after setup. Look for the 🔨 hammer icon in the chat toolbar.

Q: Do I need Node.js? Yes, Node.js 18 or higher. Download from nodejs.org.

Q: It says "TOLENO_API_KEY is not configured". Run npx mcp_toleno setup again or manually add the key to your config file.

Toleno Network

Quick Install