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.
LABSCO SUMMARY
The mining loop is three calls, which is short enough for a client to run on a schedule.
Status, start and claim are each gated by the session's own state — start refuses while one is running, claim refuses until one has ended — so a scheduled check-in either advances the cycle or says why it cannot. What the key cannot do matters as much as what it can: there is no withdrawal call and no way to change the wallet address, so the wallet tool reports limits and pending counts while moving tokens stays in the app.
What it is
A server over a Toleno Network account — mining sessions, wallet, profile and referrals — with a second set of tools that answer questions about the network itself and need no key.
What you get
- The 24-hour mining cycle handled end to end: a status call reporting elapsed and remaining time with tokens mined so far, a start that only succeeds when no session is live, and a claim once one has ended
- Wallet state in one response — withdrawable and locked balances, total ever mined, the connected address and its Solana network, today's withdrawal total with pending and completed counts, and the minimum and maximum withdrawal amounts
- A daily check-in that folds profile and session together: balance, total mined, mining power, streak and referral counts
- Referral details including the code, referred and currently active counts and the bonus percentage, plus a generated invite link with ready-made messages in English and Turkish
- Account facts the app shows in its profile screen: KYC status, phone verification, premium subscription and account creation date
- Network-level reads that take no key at all — total tokens mined and registered users, the top 50 leaderboard by balance, tokenomics with the distribution split and halving model, the roadmap, security information and an FAQ
Requirements
Node 18 or newer and a personal API key created in the Toleno mobile app under Settings → API Keys — it is shown once, so copy it then. A setup command takes the key and writes the client configuration for you. The account tools need that key; the project, tokenomics, roadmap, security, FAQ, leaderboard and global statistics tools answer without one. MIT.
Setup effort
One command plus a key — npx @toleno/mcp setup, then supply credentials
USE CASES
01
Keeping the mining cycle from idling
Check whether a session is running and how much of it is left, claim the rewards once it has ended, and start the next one — each call refuses when the session state is wrong for it.
02
Working out where the balance actually sits
The wallet call separates withdrawable from locked tokens and reports the withdrawal limits and pending count; the profile and daily summary add the streak, mining power and referral counts behind them.
03
Getting other people onto your referral code
Read the code, how many referrals are active and what bonus percentage they carry, then generate the invite link with a message already written in English or Turkish.
04
Sizing up the network before joining it
These tools return the network's own answers on supply, distribution, safeguards and common questions, with global statistics and a leaderboard to read them against. None of them need a key.
15 tools
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
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.
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_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.
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.
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.
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_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.
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_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_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.
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.
BEFORE YOU INSTALL
What to know first
Tools you get
15 tools when we connected. The documentation's table covers only seven tools. Of those, get_global_stats works without a key and the other six need TOLENO_API_KEY.
Requires
- npx on PATH
- TOLENO_API_KEY in your environment
Where it runs
Both documented clients run the server on your machine.
CONTEXT COST
Light Standing cost
Rated by the size of the 15 tool definitions that ride along on every turn, not by how many there are
INSTALLATION
Connect your client
Server setup
TERMINAL
npx @toleno/mcp setupMCP Clients
Claude Desktop, Claude Code
JSON
{
"mcpServers": {
"Toleno Network": {
"command": "npx",
"args": [
"-y",
"@toleno/mcp"
],
"env": {
"TOLENO_API_KEY": "<YOUR_TOLENO_API_KEY>"
}
}
}
}
