About Toleno Network
Toleno Network MCP Server lets Claude manage a Toleno mining account through natural language, covering balance checks, mining sessions and referrals. It is intended for existing Toleno users. The API key is stored in the local Claude configuration.
Key features
- 01Balance, mining power and level lookup
- 02Active mining session status and remaining time
- 03Start a new 24-hour mining session
- 04Claim rewards after a completed session
- 05Wallet and referral information queries
Use cases
- 01Checking current mining progress from Claude
- 02Claiming rewards once a session has ended
- 03Reviewing referral code and active referral count
MCP support
This project is an MCP server that exposes tools such as get_profile, start_mining and claim_mining to MCP clients for managing a Toleno account.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
npx -y @toleno/mcpTOLENO_API_KEYSecretYour personal API key from the Toleno app. Go to Settings → API Keys → Create New Key.Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.
Tools
15Saved tool list · updated 3w ago
This tool takes no parameters.
Details
From the project 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 setupauto-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.
Links
- Toleno App: tolenocoin.com
- npm Package: npmjs.com/package/@toleno/mcp
- GitHub: github.com/tolenonetwork/toleno-mcp
MIT © Toleno Network
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.