toleno-mcp
Toleno Network MCP Server — Control your Toleno mining account directly from Claude AI using natural language.
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/tolenonetwork--toleno-mcp)HTML
<a href="/listings/tolenonetwork--toleno-mcp"><img src="/api/listings/tolenonetwork--toleno-mcp/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
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
---
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 181 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- # @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)
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.