{
  "markdown": "# @toleno/mcp\r\n\r\n[![npm version](https://img.shields.io/npm/v/@toleno/mcp.svg)](https://www.npmjs.com/package/@toleno/mcp)\r\n[![npm downloads](https://img.shields.io/npm/dm/@toleno/mcp.svg)](https://www.npmjs.com/package/@toleno/mcp)\r\n[![Node.js](https://img.shields.io/badge/node-%3E%3D18-brightgreen)](https://nodejs.org)\r\n[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)\r\n[![MCP](https://img.shields.io/badge/MCP-compatible-orange)](https://modelcontextprotocol.io)\r\n\r\n**Toleno Network MCP Server** — Control your Toleno mining account directly from Claude AI using natural language.\r\n\r\n> Check balance · Start mining · View referrals — all without opening the app.\r\n\r\n---\r\n\r\n<!--\r\n  📹 DEMO GIF — Kayıt talimatı:\r\n  1. Claude Desktop'u aç\r\n  2. \"What is my Toleno mining status?\" yaz\r\n  3. Yanıtı göster\r\n  demo.gif olarak bu klasöre kaydet, sonra aşağıdaki satırı aktif et:\r\n-->\r\n<!-- ![Toleno MCP Demo](https://raw.githubusercontent.com/tolenonetwork/toleno-mcp/main/demo.gif) -->\r\n\r\n---\r\n\r\n## Quick Start\r\n\r\n```bash\r\nnpx @toleno/mcp setup\r\n```\r\n\r\nThe setup wizard will:\r\n1. Ask for your Toleno API key\r\n2. Validate it against the Toleno API\r\n3. Automatically update your Claude Desktop config\r\n4. Remind you to restart Claude Desktop\r\n\r\nOr non-interactive:\r\n\r\n```bash\r\nnpx @toleno/mcp setup --key tlno_your_key_here\r\n```\r\n\r\n---\r\n\r\n## Get Your API Key\r\n\r\n1. Open the **Toleno app** on your phone\r\n2. Go to **Settings → API Keys**\r\n3. Tap **\"Create New Key\"**\r\n4. Name it (e.g. `Claude Desktop`)\r\n5. **Copy it immediately** — starts with `tlno_`, shown only once\r\n\r\n---\r\n\r\n## Manual Setup\r\n\r\n### Claude Desktop\r\n\r\n| OS | Config file |\r\n|----|-------------|\r\n| Windows (classic) | `%APPDATA%\\Claude\\claude_desktop_config.json` |\r\n| Windows (Store app) | `%LOCALAPPDATA%\\Packages\\Claude_*\\LocalCache\\Roaming\\Claude\\claude_desktop_config.json` |\r\n| macOS | `~/Library/Application Support/Claude/claude_desktop_config.json` |\r\n| Linux | `~/.config/Claude/claude_desktop_config.json` |\r\n\r\n> **Tip:** `npx @toleno/mcp setup` auto-detects both Windows paths and writes to all of them.\r\n\r\n```json\r\n{\r\n  \"mcpServers\": {\r\n    \"Toleno Network\": {\r\n      \"command\": \"npx\",\r\n      \"args\": [\"-y\", \"@toleno/mcp\"],\r\n      \"env\": {\r\n        \"TOLENO_API_KEY\": \"tlno_paste_your_key_here\"\r\n      }\r\n    }\r\n  }\r\n}\r\n```\r\n\r\n### Claude Code\r\n\r\nAdd `.mcp.json` to your project root:\r\n\r\n```json\r\n{\r\n  \"mcpServers\": {\r\n    \"Toleno Network\": {\r\n      \"command\": \"npx\",\r\n      \"args\": [\"-y\", \"@toleno/mcp\"],\r\n      \"env\": {\r\n        \"TOLENO_API_KEY\": \"tlno_paste_your_key_here\"\r\n      }\r\n    }\r\n  }\r\n}\r\n```\r\n\r\n---\r\n\r\n## Available Tools\r\n\r\n| Tool | What it does | Needs key? |\r\n|------|-------------|------------|\r\n| `get_global_stats` | Total tokens mined, platform-wide user count | No |\r\n| `get_profile` | Your balance, mining power, streak, level | Yes |\r\n| `get_mining_status` | Active session, time remaining, tokens earned | Yes |\r\n| `start_mining` | Start a new 24-hour mining session | Yes |\r\n| `claim_mining` | Claim rewards after a completed session | Yes |\r\n| `get_wallet_info` | Wallet address, withdrawable balance, limits | Yes |\r\n| `get_referral_info` | Referral code, team size, active referrals | Yes |\r\n\r\n---\r\n\r\n## What You Can Ask Claude\r\n\r\n```\r\n\"What is my Toleno mining status?\"\r\n\"Start mining\"\r\n\"How many TOL tokens do I have?\"\r\n\"Show my wallet info\"\r\n\"How many referrals do I have?\"\r\n\"What are the global Toleno stats?\"\r\n\"When does my mining session end?\"\r\n```\r\n\r\n---\r\n\r\n## Example Session\r\n\r\n```\r\nYou:    What is my mining status?\r\n\r\nClaude: Your mining session is active!\r\n        ⛏  Started: 3 hours ago\r\n        ⏱  Time remaining: 21 hours\r\n        💰 Earned so far: 3.5 / 28 TOL\r\n        ✅ Keep it running to earn the full reward!\r\n\r\n---\r\n\r\nYou:    How many referrals do I have?\r\n\r\nClaude: Your referral stats:\r\n        👥 Total referrals: 12\r\n        ✅ Active today: 7\r\n        🔗 Your code: TOLENO-ABC123\r\n```\r\n\r\n---\r\n\r\n## FAQ\r\n\r\n**Q: Is my API key safe?**\r\nYour key is stored locally in the Claude config file — never sent to Claude's servers. Revoke it anytime from the Toleno app.\r\n\r\n**Q: Can Claude do anything harmful to my account?**\r\nNo. Claude can only read data, start mining sessions, and claim completed rewards. It cannot change your wallet address, withdraw tokens, or delete your account.\r\n\r\n**Q: The tools don't appear in Claude Desktop.**\r\nFully quit and restart Claude Desktop after setup. Look for the 🔨 hammer icon in the chat toolbar.\r\n\r\n**Q: Do I need Node.js?**\r\nYes, Node.js 18 or higher. Download from [nodejs.org](https://nodejs.org).\r\n\r\n**Q: It says \"TOLENO_API_KEY is not configured\".**\r\nRun `npx @toleno/mcp setup` again or manually add the key to your config file.\r\n\r\n---\r\n\r\n## Links\r\n\r\n- **Toleno App:** [tolenocoin.com](https://tolenocoin.com)\r\n- **npm Package:** [npmjs.com/package/@toleno/mcp](https://www.npmjs.com/package/@toleno/mcp)\r\n- **GitHub:** [github.com/tolenonetwork/toleno-mcp](https://github.com/tolenonetwork/toleno-mcp)\r\n\r\n---\r\n\r\nMIT © [Toleno Network](https://tolenocoin.com)\r\n",
  "bytes": 5089,
  "sha": "ad67de679ace12c53d8974606e175bf24bef5d27865e489185e63066deb18f9e",
  "repo_slug": "tolenonetwork/toleno-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_tolenonetwork_toleno_mcp_9c95a57c/readme"
}