io.github.tolenonetwork/toleno-mcp

Official

by tolenonetwork · JavaScript

Toleno Network

Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.

Manage Toleno cryptocurrency mining accounts using natural language with Claude AI.

README.md5 KBView on GitHub

@toleno/mcp

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

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

Quick Start

bash

npx @toleno/mcp 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:

bash

npx @toleno/mcp 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 (classic)	`%APPDATA%\Claude\claude_desktop_config.json`
Windows (Store app)	`%LOCALAPPDATA%\Packages\Claude_*\LocalCache\Roaming\Claude\claude_desktop_config.json`
macOS	`~/Library/Application Support/Claude/claude_desktop_config.json`
Linux	`~/.config/Claude/claude_desktop_config.json`

Tip: npx @toleno/mcp setup auto-detects both Windows paths and writes to all of them.

json

{
  "mcpServers": {
    "Toleno Network": {
      "command": "npx",
      "args": ["-y", "@toleno/mcp"],
      "env": {
        "TOLENO_API_KEY": "tlno_paste_your_key_here"
      }
    }
  }
}

Claude Code

Add .mcp.json to your project root:

json

{
  "mcpServers": {
    "Toleno Network": {
      "command": "npx",
      "args": ["-y", "@toleno/mcp"],
      "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`	Claim rewards after 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

code

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

Example Session

code

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:    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 only read data, start mining sessions, and claim completed rewards. 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 @toleno/mcp setup again or manually add the key to your config file.

Install

Configuration

Environment variables

TOLENO_API_KEYrequiredsecret

Your personal API key from the Toleno app. Go to Settings → API Keys → Create New Key.

claude_desktop_config.json

{
  "mcpServers": {
    "toleno-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@toleno/mcp@1.0.6"
      ],
      "env": {
        "TOLENO_API_KEY": "<YOUR_TOLENO_API_KEY>"
      }
    }
  }
}