Toleno Network

io.github.tolenonetworkPublished by GitHub account tolenonetworkv1.0.6Updated Oct 24, 2026

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

VerifiedSTDIODesktop onlyProductivity & WorkflowFinance

Overview

AI-generated overview

Connects Claude to a Toleno mining account so the assistant can check balances, start mining sessions, claim rewards and view referrals in natural language.

What you can do
  • Read account and platform data: global stats, profile balance, mining power, streak and level
  • Check mining status: active session, time remaining and tokens earned
  • Start a new 24-hour mining session and claim rewards from a completed one
  • Look up wallet address, withdrawable balance and limits, plus referral code and team size
When to use it
Useful if you already run a Toleno mining account and want to check status, start sessions or claim rewards from Claude Desktop instead of opening the phone app.
Requirements
Runs locally via npx, so Node.js 18 or higher is needed. A Toleno API key, created in the Toleno app under Settings → API Keys, must be supplied in the TOLENO_API_KEY environment variable. The setup wizard writes the Claude Desktop config; network access to the Toleno API is required.
Before you install
The TOLENO_API_KEY is a personal account credential stored in plain text in the Claude config file; it is shown only once and can be revoked in the app. The assistant can start mining sessions and claim rewards, which change account state. It cannot withdraw tokens or change the wallet address, according to the README. Account data is sent to the Toleno API.

Installation

In SourceWeft

  1. Open Toleno Network in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

@toleno/mcp

[npm version] [npm downloads] [Node.js] [License: MIT] [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:

  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:

bash
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.

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

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.

Links

MIT © Toleno Network

Source: README.md at commit e599573

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v1.0.6LatestSep 16, 2026

Score

40% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

    Declare a license in the repository or the registry entry.