English Français العربية

Toleno Network

Official registry AI and agents

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

Source code Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package @toleno/mcp
Claude Code 
claude mcp add toleno-network -e 'TOLENO_API_KEY=<your toleno_api_key>' -- npx -y @toleno/mcp@1.0.6
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "toleno-network": {
            "command": "npx",
            "args": [
                "-y",
                "@toleno/mcp@1.0.6"
            ],
            "env": {
                "TOLENO_API_KEY": "<your toleno_api_key>"
            }
        }
    }
}

Environment variables

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

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. @toleno/mcp
  2. Quick Start
  3. Get Your API Key
  4. Manual Setup
  5. Available Tools
  6. What You Can Ask Claude
  7. Example Session
  8. FAQ
  9. Links

@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

npx @toleno/mcp setup

The setup wizard will:

  1. Ask for your Toleno API key
  2. Validate it against the Toleno API
  3. Automatically update your Claude Desktop config
  4. Remind you to restart Claude Desktop

Or non-interactive:

npx @toleno/mcp setup --key tlno_your_key_here

Get Your API Key

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

Manual Setup

Claude Desktop
OSConfig 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.

{
  "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:

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

Available Tools

ToolWhat it doesNeeds key?
get_global_statsTotal tokens mined, platform-wide user countNo
get_profileYour balance, mining power, streak, levelYes
get_mining_statusActive session, time remaining, tokens earnedYes
start_miningStart a new 24-hour mining sessionYes
claim_miningClaim rewards after a completed sessionYes
get_wallet_infoWallet address, withdrawable balance, limitsYes
get_referral_infoReferral code, team size, active referralsYes

What You Can Ask Claude

"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

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.

MIT © Toleno Network

Frequently asked questions

What is Toleno Network?

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

How do I install Toleno Network?

It runs on your machine. In Claude Code: claude mcp add toleno-network -e 'TOLENO_API_KEY=<your toleno_api_key>' -- npx -y @toleno/mcp@1.0.6. For other clients, paste the JSON configuration from this page into their MCP settings.

Does Toleno Network need an API key?

Yes. It expects TOLENO_API_KEY, which you set in its configuration.

Is Toleno Network open source?

Its code is public on GitHub, but the repository does not declare a standard license.

Who maintains Toleno Network?

It is published by tolenonetwork. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.