Skip to content
Back to search

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.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/tolenonetwork--toleno-mcp/badge.svg)](/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

i

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)

  1. # @toleno/mcp
  2. [![npm version](https://img.shields.io/npm/v/@toleno/mcp.svg)](https://www.npmjs.com/package/@toleno/mcp)
  3. [![npm downloads](https://img.shields.io/npm/dm/@toleno/mcp.svg)](https://www.npmjs.com/package/@toleno/mcp)
  4. [![Node.js](https://img.shields.io/badge/node-%3E%3D18-brightgreen)](https://nodejs.org)
  5. [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
  6. [![MCP](https://img.shields.io/badge/MCP-compatible-orange)](https://modelcontextprotocol.io)
  7. **Toleno Network MCP Server** — Control your Toleno mining account directly from Claude AI using natural language.
  8. > Check balance · Start mining · View referrals — all without opening the app.
  9. ---
  10. <!--
  11. 📹 DEMO GIF — Kayıt talimatı:
  12. 1. Claude Desktop'u aç
  13. 2. "What is my Toleno mining status?" yaz
  14. 3. Yanıtı göster
  15. demo.gif olarak bu klasöre kaydet, sonra aşağıdaki satırı aktif et:
  16. -->
  17. <!-- ![Toleno MCP Demo](https://raw.githubusercontent.com/tolenonetwork/toleno-mcp/main/demo.gif) -->
  18. ---
  19. ## Quick Start
  20. ```bash
  21. npx @toleno/mcp setup
  22. ```
  23. The setup wizard will:
  24. 1. Ask for your Toleno API key
  25. 2. Validate it against the Toleno API
  26. 3. Automatically update your Claude Desktop config
  27. 4. Remind you to restart Claude Desktop
  28. Or non-interactive:
  29. ```bash
  30. npx @toleno/mcp setup --key tlno_your_key_here
  31. ```
  32. ---
  33. ## Get Your API Key
  34. 1. Open the **Toleno app** on your phone
  35. 2. Go to **Settings → API Keys**
  36. 3. Tap **"Create New Key"**
  37. 4. Name it (e.g. `Claude Desktop`)
  38. 5. **Copy it immediately** — starts with `tlno_`, shown only once
  39. ---
  40. ## Manual Setup
  41. ### Claude Desktop
  42. | OS | Config file |
  43. |----|-------------|
  44. | Windows (classic) | `%APPDATA%\Claude\claude_desktop_config.json` |
  45. | Windows (Store app) | `%LOCALAPPDATA%\Packages\Claude_*\LocalCache\Roaming\Claude\claude_desktop_config.json` |
  46. | macOS | `~/Library/Application Support/Claude/claude_desktop_config.json` |
  47. | Linux | `~/.config/Claude/claude_desktop_config.json` |
  48. > **Tip:** `npx @toleno/mcp setup` auto-detects both Windows paths and writes to all of them.
  49. ```json
  50. {
  51. "mcpServers": {
  52. "Toleno Network": {
  53. "command": "npx",
  54. "args": ["-y", "@toleno/mcp"],
  55. "env": {
  56. "TOLENO_API_KEY": "tlno_paste_your_key_here"
  57. }
  58. }
  59. }
  60. }
  61. ```
  62. ### Claude Code
  63. Add `.mcp.json` to your project root:
  64. ```json
  65. {
  66. "mcpServers": {
  67. "Toleno Network": {
  68. "command": "npx",
  69. "args": ["-y", "@toleno/mcp"],
  70. "env": {
  71. "TOLENO_API_KEY": "tlno_paste_your_key_here"
  72. }
  73. }
  74. }
  75. }
  76. ```
  77. ---
  78. ## Available Tools
  79. | Tool | What it does | Needs key? |
  80. |------|-------------|------------|
  81. | `get_global_stats` | Total tokens mined, platform-wide user count | No |
  82. | `get_profile` | Your balance, mining power, streak, level | Yes |
  83. | `get_mining_status` | Active session, time remaining, tokens earned | Yes |
  84. | `start_mining` | Start a new 24-hour mining session | Yes |
  85. | `claim_mining` | Claim rewards after a completed session | Yes |
  86. | `get_wallet_info` | Wallet address, withdrawable balance, limits | Yes |
  87. | `get_referral_info` | Referral code, team size, active referrals | Yes |
  88. ---
  89. ## What You Can Ask Claude
  90. ```
  91. "What is my Toleno mining status?"
  92. "Start mining"
  93. "How many TOL tokens do I have?"
  94. "Show my wallet info"
  95. "How many referrals do I have?"
  96. "What are the global Toleno stats?"
  97. "When does my mining session end?"
  98. ```
  99. ---
  100. ## Example Session
  101. ```
  102. You: What is my mining status?
  103. Claude: Your mining session is active!
  104. ⛏ Started: 3 hours ago
  105. ⏱ Time remaining: 21 hours
  106. 💰 Earned so far: 3.5 / 28 TOL
  107. ✅ Keep it running to earn the full reward!
  108. ---
  109. You: How many referrals do I have?
  110. Claude: Your referral stats:
  111. 👥 Total referrals: 12
  112. ✅ Active today: 7
  113. 🔗 Your code: TOLENO-ABC123
  114. ```
  115. ---
  116. ## FAQ
  117. **Q: Is my API key safe?**
  118. Your key is stored locally in the Claude config file — never sent to Claude's servers. Revoke it anytime from the Toleno app.
  119. **Q: Can Claude do anything harmful to my account?**
  120. 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.
  121. **Q: The tools don't appear in Claude Desktop.**
  122. Fully quit and restart Claude Desktop after setup. Look for the 🔨 hammer icon in the chat toolbar.
  123. **Q: Do I need Node.js?**
  124. Yes, Node.js 18 or higher. Download from [nodejs.org](https://nodejs.org).
  125. **Q: It says "TOLENO_API_KEY is not configured".**
  126. Run `npx @toleno/mcp setup` again or manually add the key to your config file.
  127. ---
  128. ## Links
  129. - **Toleno App:** [tolenocoin.com](https://tolenocoin.com)
  130. - **npm Package:** [npmjs.com/package/@toleno/mcp](https://www.npmjs.com/package/@toleno/mcp)
  131. - **GitHub:** [github.com/tolenonetwork/toleno-mcp](https://github.com/tolenonetwork/toleno-mcp)
  132. ---
  133. MIT © [Toleno Network](https://tolenocoin.com)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.