# Toleno Network [Health: Active]

**Category:** 💰 Finance & Fintech  
**Repository:** https://github.com/tolenonetwork/toleno-mcp  
**GitHub Stars:** 251  
**npm Downloads (last month):** 117  
**Views:** 1  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/toleno-network-2

## Description
Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.

## Tools
Capabilities this server exposes over MCP:

- **get_global_stats** — Get global Toleno Network statistics: total tokens mined across all users and total registered user count. This is a public endpoint — no API key required.
- **get_leaderboard** — Get the TOP 50 leaderboard of Toleno users ranked by token balance. Returns username, display name, token balance, mining power, and rank for each user. This is a public endpoint and requires no API key.
- **get_mining_status** — Get the current mining session status for the authenticated Toleno user. Returns whether a session is active or completed, start/end times, elapsed and remaining time in milliseconds, tokens mined so far, total tokens to be earned, and whether rewards are ready to claim.
- **start_mining** — Start a new 24-hour mining session for the authenticated Toleno user. Can only be called when no active session exists. Returns the session details including start/end times and expected token earnings.
- **claim_mining** — Claim mining rewards after a completed 24-hour session. Can only be called when a session has ended and rewards are ready to collect. Returns the amount of tokens claimed and the new balance.
- **get_wallet_info** — Get comprehensive wallet information for the authenticated Toleno user. Returns the available (withdrawable) token balance, locked mining balance, total tokens ever mined, the connected wallet address and preferred network (Solana), withdrawal statistics (today's total, pending count, completed count), and the minimum/maximum withdrawal amounts.
- **get_profile** — Get the full profile of the authenticated Toleno user. Returns username, display name, email, token balance, total tokens mined, mining power multiplier, referral count, active referral count, wallet address, KYC status, phone verification status, premium subscription status, current daily streak, and account creation date.
- **daily_summary** — Get a comprehensive daily summary for the authenticated Toleno user. Combines profile data and mining status into a single overview: token balance, total mined, mining power, daily streak, referral stats, and current mining session details (active/completed/claimable, tokens mined, remaining time). Perfect for a quick daily check-in.
- **get_referral_info** — Get referral program details for the authenticated Toleno user. Returns the referral code (same as username), total number of users referred, number of currently active mining referrals, the referral bonus percentage applied to earnings, and the shareable referral link.
- **generate_invite_link** — Generate a shareable invite link and ready-to-send invite messages (in English and Turkish) for the authenticated Toleno user. Use this when the user wants to invite friends or share their referral link.
- **get_project_info** — Get general information about Toleno Network: what it is, blockchain, token details, website, social links, and app download links. This is a public tool — no API key required.
- **get_tokenomics** — Get TOLENO tokenomics: total supply, distribution breakdown (mining, ecosystem, team, liquidity, marketing), mining mechanism details (session duration, rewards, halving model). This is a public tool — no API key required.
- **get_roadmap** — Get the Toleno Network development roadmap: completed phases, current progress, and upcoming milestones including Solana deployment and DEX listing. This is a public tool — no API key required.
- **get_security_info** — Get Toleno Network security and trust information: security measures, trust indicators, and upcoming milestones. Use this when users ask "is Toleno safe?", "is it trustworthy?", "is it a scam?" etc. This is a public tool — no API key required.
- **get_faq** — Get frequently asked questions about Toleno Network: what it is, how mining works, token withdrawal, blockchain info, pricing, referral system, Claude AI integration, and trustworthiness. This is a public tool — no API key required.

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "toleno-network": {
    "command": "npx",
    "args": ["-y","@toleno/mcp"]
  }
}
```

## Documentation & README

# @toleno/mcp

[![npm version](https://img.shields.io/npm/v/@toleno/mcp.svg)](https://www.npmjs.com/package/@toleno/mcp)
[![npm downloads](https://img.shields.io/npm/dm/@toleno/mcp.svg)](https://www.npmjs.com/package/@toleno/mcp)
[![Node.js](https://img.shields.io/badge/node-%3E%3D18-brightgreen)](https://nodejs.org)
[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
[![MCP](https://img.shields.io/badge/MCP-compatible-orange)](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:
-->
<!-- ![Toleno MCP Demo](https://raw.githubusercontent.com/tolenonetwork/toleno-mcp/main/demo.gif) -->

---

## 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)

