Toleno Network
Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.
Open source Open in the app JSON README (API)
About
Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.
Details
- Kind
- MCP servers
- Topic
- No topic detected
- Publisher
- tolenonetwork
- Origin
- official
- Category
- ferramentas
- Transport
- local
- Version
- 1.0.6
- Stars
- 219
- Forks
- 16
- Open pull requests
- 1
- Last push
- 2026-02-25T08:17:44Z
- Repository state
- ativo
- Language
- JavaScript
- Added
- 2026-08-29 04:01:33
- Updated
- 2026-08-29 04:01:33
- Origin id
io.github.tolenonetwork/toleno-mcp
README
# @toleno/mcp
[](https://www.npmjs.com/package/@toleno/mcp)
[](https://www.npmjs.com/package/@toleno/mcp)
[](https://nodejs.org)
[](https://opensource.org/licenses/MIT)
[](https://modelcontextprotocol.io)
**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.
---
<!--
📹 DEMO GIF — Kayıt talimatı:
1. Claude Desktop'u aç
2. "What is my Toleno mining status?" yaz
3. Yanıtı göster
demo.gif olarak bu klasöre kaydet, sonra aşağıdaki satırı aktif et:
-->
<!--  -->
---
## 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
| 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
```
"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](https://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](https://tolenocoin.com)
- **npm Package:** [npmjs.com/package/@toleno/mcp](https://www.npmjs.com/package/@toleno/mcp)
- **GitHub:** [github.com/tolenonetwork/toleno-mcp](https://github.com/tolenonetwork/toleno-mcp)
---
MIT © [Toleno Network](https://tolenocoin.com)