How do I install Toleno?

Toleno is a local plugin. Install it using npm package: @toleno/mcp and add the generated configuration snippet to your AI app's MCP config file. Then restart your AI app.

Is Toleno safe to use?

Yes. Toleno passed MCP Marketplace's automated security scan with a score of 8/10 (low risk). Every server on MCP Marketplace is security-scanned before it's listed; see the full security report on this page for the findings and permissions.

What credentials does Toleno need?

Toleno requires the following credentials or environment variables: TOLENO_API_KEY. You can find setup instructions on the server detail page.

What AI apps work with Toleno?

Toleno uses the Model Context Protocol (MCP) and works with any MCP-compatible AI app, including Claude, ChatGPT / Codex, Gemini, Copilot, Cursor, and more.

Back to Browse

Toleno MCP Server

by Toleno

Developer ToolsLow Risk8.0Local

Free

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

About

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

Security Report

8.0

Low Risk8.0Low Risk

Valid MCP server (1 strong, 0 medium validity signals). 2 known CVEs in dependencies (0 critical, 2 high severity) Package registry verified. Imported from the Official MCP Registry.

10 files analyzed · 3 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

file_system

Check that this permission is expected for this type of plugin.

HTTP Network Access

Connects to external APIs or services over the internet.

env_vars

Check that this permission is expected for this type of plugin.

What You'll Need

Set these up before or after installing:

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

Environment variable: TOLENO_API_KEY

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "io-github-tolenonetwork-toleno-mcp": {
      "env": {
        "TOLENO_API_KEY": "your-toleno-api-key-here"
      },
      "args": [
        "-y",
        "@toleno/mcp"
      ],
      "command": "npx"
    }
  }
}

Documentation

View on GitHub

From the project's GitHub README.

@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:

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

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

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

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

Reviews

4.88 ratings · 3 reviews

Khairul Akbar3 weeks ago

The best toleno network

User3 weeks ago

Yes

User5 months ago

Great project

FinAgent

Free

by mcp-marketplace · Finance

Free stock data and market news for any MCP-compatible AI assistant.