Skip to main content
Glama
Toleno Network MCP Server

Toleno Network MCP Server

Official

@toleno/mcp

npm version npm downloads Node.js License: MIT MCP

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.



Quick Start

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

Related MCP server: MCP NEAR Wallet Server

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.

{
  "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:

{
  "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.

Q: It says "TOLENO_API_KEY is not configured". Run npx @toleno/mcp setup again or manually add the key to your config file.



MIT © Toleno Network

Available Tools

15 tools
claim_miningA

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.

Inputs: no named parameters.

daily_summaryA

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.

Inputs: no named parameters.

get_faqA

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.

Inputs: topic.

get_global_statsA

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.

Inputs: no named parameters.

get_leaderboardA

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.

Inputs: limit.

get_mining_statusA

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.

Inputs: no named parameters.

get_profileA

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.

Inputs: no named parameters.

get_project_infoA

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.

Inputs: no named parameters.

get_referral_infoA

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.

Inputs: no named parameters.

get_roadmapA

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.

Inputs: no named parameters.

get_security_infoA

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.

Inputs: no named parameters.

get_tokenomicsA

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.

Inputs: no named parameters.

get_wallet_infoA

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.

Inputs: no named parameters.

start_miningA

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.

Inputs: no named parameters.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.4/5.0

    Scored across 15 tools

    Disambiguation5/5

    Every tool has a clearly distinct purpose. Mining tools (start_mining, get_mining_status, claim_mining) are separate stages with no overlap. User info tools (get_profile, get_wallet_info, daily_summary) target different aspects. Public info tools (get_faq, get_global_stats, etc.) are clearly scoped. No two tools are ambiguous.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern using snake_case: start_mining, claim_mining, get_profile, get_wallet_info, generate_invite_link, etc. The naming is predictable and intuitive.

    Tool Count5/5

    15 tools is well-scoped for a network/mining platform. It covers user actions, public information, and system interaction without being overwhelming or too sparse.

    Completeness5/5

    The tool surface covers the full lifecycle: profile retrieval, mining session management (start, status, claim), wallet info, referral system, global stats, leaderboard, and extensive project documentation (FAQ, roadmap, tokenomics, security). No obvious gaps for the stated domain.

    Maintenance

    ActivityInactive
    ResponsivenessLimited data

    Related MCP Connectors

    Related MCP Servers