GoMining MCP Server

What is GoMining MCP Server?

GoMining MCP Server is a connector that links your AI assistant (such as Claude) directly to your GoMining account. It allows you to extract and analyze account information through your LLMs, without opening the app.

For example, you can ask:

What is my BTC balance?
How much have I earned from mining this month?
Can you suggest ways to optimize my mining rewards?

Your AI assistant will create a response backed by real personalized data drawn from your account.

WARNING

Responses are AI-generated, so always double-check important information.

What tools are available?

Below is the full list of tools available through the GoMining MCP Server, grouped by area.

NOTE

All tools are read-only. They return data from your GoMining account but cannot make changes to it.

Wallet

get_virtual_wallet_balances — Returns the balance of your GoMining account wallet across all your assets (BTC, GMT, USDT, USDC, ETH, BNB, SOL, and TON).
get_deposit_addresses — Returns deposit addresses for your GoMining account, along with the supported network and asset for each one.
get_conversion_quote — Returns a conversion quote between two assets in your account, showing the exchange rate and how much you'll receive.
get_transaction_history — Returns the history of deposits and withdrawals on your wallet, including amount, asset, and status for each transaction.

Miners

get_nfts — Returns the list of miners you own, including their name, hashrate, energy efficiency, and current status.
get_nft_detail — Returns full details for a specific miner, including its hashrate, energy efficiency, current price, ROI and payback period, daily and total income, rarity, and upgrade level.
get_nft_mining_rewards — Returns your daily mining income across all your miners over a chosen date range, with the total BTC earned for each day.
get_nft_upgrade_total — Returns your overall miner upgrade stats, including how many upgrades you've made, how many of your miners are upgraded, and the total GMT and USD spent on upgrades.

Market data

get_ticker_prices — Returns the current market prices of cryptocurrencies (like BTC, ETH, GMT) and fiat currencies (like USD, EUR).

Card

get_cards — Returns the list of your GoMining Cards, including each card's status, last 4 digits, whether it's been issued, whether a PIN is set, and whether it's added to Apple Pay or Google Wallet.
get_card_balance — Returns the balance of your GoMining Card across all your assets (BTC, GMT, USDC, and USDT).
get_card_transactions — Returns the history of your GoMining Card transactions, including top-ups, payments, and refunds, with amount, asset, and status for each one.
get_card_transaction_detail — Returns full details of a specific GoMining Card transaction, including payment information, refund status, and the amount in EUR.

Staking

get_staking_positions — Returns your active veGOMINING staking positions, including the amount of GMT locked, your votes, when the lock started, and how many days until it expires.
get_staking_types — Returns available staking types and their parameters.

Account

get_kyc_status — Returns your KYC verification status, along with your country and whether the verification has expired.
get_referral_link — Returns your referral code and shareable link, plus whether the referral program is available for your account.
get_referral_stats — Returns the stats of your referral program, including your referral code, the number of friends invited, total rewards earned in USD, and a breakdown by reward type.
get_avatars — Returns the avatars you own that can be set as your profile picture, including which one is currently active.
get_avatar_collections — Lists avatars available for purchase, filtered by race (Humans, Sentinels, Cryptiles, or Luminars) and which marketplace they're listed on.
get_account_summary — Returns a quick overview of your account, including wallet balances, number of miners owned, VIP status, and active staking positions.

Miner Wars

get_miner_wars_mining_income — Returns your Miner Wars income over a chosen date range, aggregated by period.
get_spells — Returns all available Miner Wars spells, including each spell's type, tier, price in GOMINING, and how many free uses you have.

Marketplace

get_marketplace_pricing — Returns miners available for purchase on the official GoMining marketplace, including each collection's price, total hashrate, price per TH, ROI multiplier, and sale status.
search_secondary_marketplace — Searches miners listed on the second marketplace (where users sell to each other), with filters by price currency, hashrate range, price range, and collection.
get_marketplace_listing — Returns your own miner listings on the second marketplace, with the option to look up a specific miner.
get_my_marketplace_orders — Returns your own sell orders on the second marketplace, both active and past ones.

Simple Earn

check_simple_earn_eligibility — Checks whether you can use Simple Earn, including whether you're already enrolled, and the reason if you can't (for example, country restrictions).
get_simple_earn_status — Returns your Simple Earn enrollment status (the passive income feature that lets you earn BTC rewards on your crypto balances), along with your country, VIP level, and VIP subscription status.
get_simple_earn_rewards — Returns the history of your Simple Earn rewards by cycle, including balance, APR, price, BTC reward earned, and VIP multiplier applied for each asset.
get_simple_earn_reward_totals — Returns the total Simple Earn rewards you've earned, including your all-time total in BTC and USD, the rewards from the last cycle, and a breakdown by asset.
get_simple_earn_config — Returns the current Simple Earn rates, including the APR for each supported asset (USDT, USDC, ETH, BNB, TON, SOL) and the multipliers applied to each VIP level.

VIP & Loyalty

get_vip_level — Returns your current VIP status, including your tier, maintenance discount, card cashback rate, and Launchpad tier.
get_vip_benefits — Returns the full breakdown of benefits at your current VIP level, including maintenance discount, reinvestment bonus, card cashback rate, Simple Earn multiplier, card transaction fees, Launchpad tier, and unlocked features.
get_vip_progress — Returns your current VIP level alongside all VIP tiers, including the hashrate or veGOMINING votes required for each tier and the benefits each one unlocks.
get_vip_subscription — Returns your VIP Platinum Subscription+ status.
get_cashback_stats — Returns your cashback setup, including which of your miners receives the TH cashback, your VIP level, and the cashback percentages for card payments, merchant payments, and card referrals.
get_cashback_history — Returns the history of your cashback earnings, with the original transaction amount, its USD value, the TH credited to your miner, and the processing status for each entry.

Launchpad

get_launchpad_projects — Returns BTCFi token sales available on the GoMining Launchpad, including each project's description, token price, sale and registration dates, current phase, network, and any KYC or country restrictions.
get_launchpad_allocation — Returns your Launchpad tier and allocation amount based on your VIP level, for a specific wallet address.
get_launchpad_tier_config — Returns how Launchpad tiers are set up, including the requirements for each tier and the allocation amount available at each level.

Academy

get_academy_courses — Returns all available courses in the GoMining Academy, including each course's title, description, difficulty level, and your progress (when you started, when you completed it, and your rating).
get_course_progress — Returns your progress on a specific Academy course, including its title, description, difficulty level, when you started, when you completed it, and your rating.

What can I use it for?

Here are a few examples of how you can use the GoMining MCP Server:

Portfolio overview — Ask for a summary of your miners, balances, and mining income in one message instead of navigating across multiple sections in the app.
Daily check-in — Set your agent and get a daily digest made for you while you're sleeping.
Miner analysis — Compare your digital miners by hashrate, efficiency, or rarity to identify which ones perform best and get suggestions on how to improve your mining farm's performance.
Staking and Simple Earn tracking — Monitor your veGOMINING staking positions and Simple Earn rewards.
Deposit flow — Ask for a deposit address for a specific currency and network; useful when you need it quickly during a transaction.
Market context — Request current prices for GOMINING or other supported assets alongside your account data to get a fuller picture.

Who can use it?

The connector is available to all GoMining users and works with:

Claude.ai
Claude Code
Cursor
Windsurf
Any AI tool that supports MCP connections

How do I connect on Claude.ai?

Follow these steps to connect the GoMining MCP Server to Claude in your browser:

Log in to your GoMining account at app.gomining.com.
Open Claude.ai, click your profile icon, and go to Settings → Connectors.
Click Add custom connector and enter the following URL: https://mcp.gomining.com/mcp
A sign-in page will open. Log in with your GoMining account and click Authorize.
Once connected, start a new chat and ask Claude about your account.

How do I connect on another AI tool?

If your tool supports MCP, add the following as a remote MCP server in its settings: https://mcp.gomining.com/mcp

Can the AI make changes to my account?

Currently, the GoMining MCP Server supports read access only — the AI can view your account data and answer questions, but cannot perform actions such as transfers, purchases, or settings changes.

During setup you will see a consent screen where you can choose which permissions to grant. Write access may be added in future releases; for now, only read access is functional.

What should I do if something is not working?

Connection failed or "unauthorized" error — Make sure you are logged in to app.gomining.com and then try connecting again.
The AI returns no data — This may mean the feature is not yet active on your account. For example, if you have no digital miners or have not activated Simple Earn, those queries will return empty results. This is expected behavior.
Still experiencing issues? — Please contact the GoMining support team via live chat on app.gomining.com or by email at [email protected].