SolidInvoice
Create and send invoices and quotes, manage clients, and track payments in SolidInvoice.
ASIC solar/battery profit. Keyless MCP 20/min+200/day; paid 25/1k/10k/50k. Not financial advice.
Lists are ordered by a usage score (out of 100) built from these parts
| Popularity | 0/80 | GitHub stars or weekly downloads: the larger counts 60, the smaller 20 |
|---|---|---|
| Freshness | 12/12 | Full marks for a release or code change within 30 days |
| Still answering | 0/8 | The cloud endpoint answered at the last check |
| Usage score | 12/100 |
Quality: Passed 4/5 basic checks (shown, not used for ordering) · Momentum: No data yet (Used only on the Trending tab)
Pick the AI app you use, then copy the settings.
Let your AI install it with one sentence
Please install MinerYield. Follow https://mcp.popnx.com/i/nadeaup-mineryield-mcp.md, show me the commands and wait for my OK before running them.Paste it into an AI that can work on your computer (such as Claude Code or Cursor). It reads our steps, shows you the commands and waits for your OK. No key, no sign-up. · See the full text your AI reads
Passed 4/5 checks · Runs on your computer
We hid some of the commands
Connect by URL: the server address did not answer when we checked
Use “Run on your computer” instead; the steps are below
First: which AI do you use?
Pick your app and the steps appear below.
Works with Claude, with some setup first
You need a MinerYield key (create it on the maker’s site) · Install Node.js on your computer first (one time) · Only the Claude desktop app (Windows or Mac), not the web or phone
Copy this message into a Claude chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.
Please install the MCP server MinerYield for Claude on this computer, in this order: 1) Check Node.js with node -v. If it is missing, tell me to install it from https://nodejs.org/en/download; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): { "mcpServers": { "mineryield": { "command": "npx", "args": [ "-y", "mineryield-mcp" ], "env": { "MINERYIELD_API_KEY": "your-value" } } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) For MINERYIELD_API_KEY, leave "your-value" in place and tell me to paste the real value myself into the file or the app’s field. Never ask me to type a key in chat. 5) Do what we agreed, then check that the MinerYield tools really show up.This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.
Already installed? Check first · Open Terminal, type this command and press Enter
node -vMac: press ⌘ + Space, type Terminal, press Enter
Windows: open Start, type Windows PowerShell, then Open
Not installed: Open the official download page, pick the LTS version and the click-through installer: .pkg on Mac · .msi on Windows. Double-click and follow it to the end. No curl command needed
Open the Node.js download page ↗
When it’s done, close Terminal, open it again and run the same command. You should see a version number: node -v
Install once; it works for everything that needs Node.js
Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.
SettingsDeveloperEdit Config
{
"mcpServers": {
"mineryield": {
"command": "npx",
"args": [
"-y",
"mineryield-mcp"
],
"env": {
"MINERYIELD_API_KEY": "your-value"
}
}
}
}Paste the key only into the app’s field, never into a chat or to anyone
Use MinerYield and tell me what you can do for me, then show me one thing✓ If Claude says it is using MinerYield or shows a MinerYield tool in the answer, you are connected
The command above works without these. Add them only if you want to change something, following the maker’s description.
MINERYIELD_API_BASE_URL Optional API origin. Defaults to https://mineryield.com.Descriptions are as written by the maker.
Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version
ChatGPT cannot connect MinerYield yet
MinerYield runs on your computer, but ChatGPT can only connect servers that run on the web
A · Use an app that can connect MinerYield
B · Others in Accounting, finance & tax that work with ChatGPT
Picked from the most used in the same category, only ones that connect by address with no key
Works with Claude Code, with some setup first
You need a MinerYield key (create it on the maker’s site) · Install Node.js on your computer first (one time)
Copy this message into a Claude Code chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.
Please install the MCP server MinerYield for Claude Code on this computer, in this order: 1) Check Node.js with node -v. If it is missing, tell me to install it from https://nodejs.org/en/download; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): claude mcp add --scope user mineryield --env MINERYIELD_API_KEY=your-value -- npx -y mineryield-mcp 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) For MINERYIELD_API_KEY, leave "your-value" in place and tell me to paste the real value myself into the file or the app’s field. Never ask me to type a key in chat. 5) Do what we agreed, then check that the MinerYield tools really show up.This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.
Already installed? Check first · Open Terminal, type this command and press Enter
node -vMac: press ⌘ + Space, type Terminal, press Enter
Windows: open Start, type Windows PowerShell, then Open
Not installed: Open the official download page, pick the LTS version and the click-through installer: .pkg on Mac · .msi on Windows. Double-click and follow it to the end. No curl command needed
Open the Node.js download page ↗
When it’s done, close Terminal, open it again and run the same command. You should see a version number: node -v
Install once; it works for everything that needs Node.js
Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.
Mac: press Command+Space and type Terminal · Windows: open PowerShell
claude mcp add --scope user mineryield --env MINERYIELD_API_KEY=your-value -- npx -y mineryield-mcpReplace “your-value” with your key before pressing Enter
Paste the key only into the app’s field, never into a chat or to anyone
You should see MinerYield listed as connected
Use MinerYield and tell me what you can do for me, then show me one thing✓ If Claude Code says it is using MinerYield or shows a MinerYield tool in the answer, you are connected
The command above works without these. Add them only if you want to change something, following the maker’s description.
MINERYIELD_API_BASE_URL Optional API origin. Defaults to https://mineryield.com.Descriptions are as written by the maker.
Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version
Works with Cursor, with some setup first
You need a MinerYield key (create it on the maker’s site) · Install Node.js on your computer first (one time)
Copy this message into a Cursor chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.
Please install the MCP server MinerYield for Cursor on this computer, in this order: 1) Check Node.js with node -v. If it is missing, tell me to install it from https://nodejs.org/en/download; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): { "mcpServers": { "mineryield": { "command": "npx", "args": [ "-y", "mineryield-mcp" ], "env": { "MINERYIELD_API_KEY": "your-value" } } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) For MINERYIELD_API_KEY, leave "your-value" in place and tell me to paste the real value myself into the file or the app’s field. Never ask me to type a key in chat. 5) Do what we agreed, then check that the MinerYield tools really show up.This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.
Already installed? Check first · Open Terminal, type this command and press Enter
node -vMac: press ⌘ + Space, type Terminal, press Enter
Windows: open Start, type Windows PowerShell, then Open
Not installed: Open the official download page, pick the LTS version and the click-through installer: .pkg on Mac · .msi on Windows. Double-click and follow it to the end. No curl command needed
Open the Node.js download page ↗
When it’s done, close Terminal, open it again and run the same command. You should see a version number: node -v
Install once; it works for everything that needs Node.js
Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.
In the MinerYield settings, MINERYIELD_API_KEY is empty; add your key and save
Paste the key only into the app’s field, never into a chat or to anyone
Use MinerYield and tell me what you can do for me, then show me one thing✓ If Cursor says it is using MinerYield or shows a MinerYield tool in the answer, you are connected
The command above works without these. Add them only if you want to change something, following the maker’s description.
MINERYIELD_API_BASE_URL Optional API origin. Defaults to https://mineryield.com.Descriptions are as written by the maker.
Menu names checked against Cursor’s help page on Nov 11, 2026 · your screen may differ slightly by app version
Works with VS Code, with some setup first
You need a MinerYield key (create it on the maker’s site) · Install Node.js on your computer first (one time)
Copy this message into a VS Code chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.
Please install the MCP server MinerYield for VS Code on this computer, in this order: 1) Check Node.js with node -v. If it is missing, tell me to install it from https://nodejs.org/en/download; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): { "servers": { "mineryield": { "type": "stdio", "command": "npx", "args": [ "-y", "mineryield-mcp" ], "env": { "MINERYIELD_API_KEY": "your-value" } } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) For MINERYIELD_API_KEY, leave "your-value" in place and tell me to paste the real value myself into the file or the app’s field. Never ask me to type a key in chat. 5) Do what we agreed, then check that the MinerYield tools really show up.This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.
Already installed? Check first · Open Terminal, type this command and press Enter
node -vMac: press ⌘ + Space, type Terminal, press Enter
Windows: open Start, type Windows PowerShell, then Open
Not installed: Open the official download page, pick the LTS version and the click-through installer: .pkg on Mac · .msi on Windows. Double-click and follow it to the end. No curl command needed
Open the Node.js download page ↗
When it’s done, close Terminal, open it again and run the same command. You should see a version number: node -v
Install once; it works for everything that needs Node.js
Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.
In the MinerYield settings, MINERYIELD_API_KEY is empty; add your key and save
Paste the key only into the app’s field, never into a chat or to anyone
Use MinerYield and tell me what you can do for me, then show me one thing✓ If VS Code says it is using MinerYield or shows a MinerYield tool in the answer, you are connected
The command above works without these. Add them only if you want to change something, following the maker’s description.
MINERYIELD_API_BASE_URL Optional API origin. Defaults to https://mineryield.com.Descriptions are as written by the maker.
Menu names checked against VS Code’s help page on Nov 11, 2026 · your screen may differ slightly by app version
Other apps that use MCP, such as Windsurf, Zed or Gemini CLI, each add servers differently. See how in the app list.
JSON settings are under “For developers” below
Claude Code
claude mcp add --scope user mineryield --env MINERYIELD_API_KEY=your-value -- npx -y mineryield-mcpClaude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"mineryield": {
"command": "npx",
"args": [
"-y",
"mineryield-mcp"
],
"env": {
"MINERYIELD_API_KEY": "your-value"
}
}
}
}Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"mineryield": {
"command": "npx",
"args": [
"-y",
"mineryield-mcp"
],
"env": {
"MINERYIELD_API_KEY": "your-value"
}
}
}
}VS Code (mcp.json)
{
"servers": {
"mineryield": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"mineryield-mcp"
],
"env": {
"MINERYIELD_API_KEY": "your-value"
}
}
}
}MINERYIELD_API_KEY secret required envMINERYIELD_API_BASE_URL envDescriptions are as written by the maker.
These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.
npm: mineryield-mcpBased on how this server connects and on each app’s own docs, checked Nov 10, 2026.
Connect over the internet in
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatOpen WebUIRaycast
Run on your computer in
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast
Tool names and descriptions exactly as the server reported them on Nov 16, 2026. The maker wrote them, not us; we show them as plain text.
list_minersGET /api/v1/miners — rank catalog ASICs by daily profit for a home or small-business solar+battery+grid setup (same model as the site calculator). Optional solarW (10000=10 kW), batteryCapacity (kWh), zipCode, elecCost, and powerSources override the API-key owner profile. Example
get_rigsGET /api/v1/rigs — the signed-in API-key owner's saved My Rigs list with per-unit yield estimates, including NiceHash daily revenue (USD/day) when a market rate exists (null otherwise). Figures are MinerYield model estimates from live market inputs: estimates only, not investment
calculate_profitabilityPOST /api/v1/calculator — one-machine home/small-business profitability with the same solar/battery/grid leftover-watt model as the site. Required: hashrate, power, algorithm, elecCost. Optional: solarW, batteryCapacity, zipCode, powerSources. Example: 3 kW miner on solar by day,
get_marketGET /api/v1/market — live spot prices for BTC, BCH, LTC, DOGE, ZEC, KAS, CKB, RXD, SC, DCR, DASH, GRIN, ALPH, XTM, ETC, XMR, ALEO, HNS, BTCB2, KDA, NEXA, XP, QUAI, ARRR, OCTA, ETHW, QKC, MWC, SCP. Prices can move; not a trading feed.
get_solar_forecastGET /api/v1/solar-forecast — 7-day estimated kWh from a home/small-business solar array (US ZIP + capacityW, 10000=10 kW). Weather-based production only; pair with calculate_profitability or list_miners for miner profit.
get_difficulty_predictionGET /api/v1/difficulty-prediction — 7-day network difficulty trend for a coin (default BTC). Model estimate, not a guarantee.
list_catalog_minersGET /api/v1/catalog/miners — public ASIC catalog (specs only, no user profitability). Includes Kadena/KDA, NexaPow/NEXA, XPHash/XP, zkSNARK/ALEO, Blake3/ALPH, and SHA-256 QUAI-capable SKUs under 5000 W. Goldshell HS-Lite is one row (`hs-lite`) with dual modes (Blake2B-SHA3/HNS an
list_mrr_ratesGET /api/v1/mrr-rates — public cached Mining Rig Rentals algorithm rates. SHA3X, zkSNARK, Blake256R14, Kadena, and XPHash have no primary MRR book (null). NexaPow maps to the MRR nexapow book. No API key required. Market snapshot, not a rental booking.
list_nicehash_ratesGET /api/v1/nicehash-rates — public cached NiceHash algorithm paying rates (sat per H/s or Sol/s per day). SHA3X, zkSNARK, Blake256R14, Kadena, and XPHash have no NiceHash paying book (null). No API key required. Market snapshot used for My Rigs NiceHash revenue ($/day), not a re
get_market_dataGET /api/v1/market-data — public full market payload (prices plus network hashrate/difficulty used by the web app), including KDA, NEXA, XP, QUAI, ARRR, OCTA, ETHW, QKC, MWC, and SCP. New-coin and XP hashRate/blockReward may be null/omitted. No API key required. Broader than get_
We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 20, 2026
The registry name was verified with the GitHub account nadeaup, which owns the repo
Code last changed 9 days ago
Uses MIT
Did not respond within 6 seconds when we checked
Did not respond within 6 seconds when we checked
Read 10 tool descriptions and found no hidden instructions to the AI
No entries on OSV.dev for mineryield-mcp@1.0.2
Checks only this package version, not every dependency · checked Nov 15, 2026
If you made this, paste this code into your README. The badge links back to this page.
[](https://mcp.popnx.com/en/servers/nadeaup-mineryield-mcp)Ask, share a tip or report that it does not work. Sorted by what people marked helpful.
No posts yet. Be the first to ask or share.
Posts here are written by users, not the PopNx team.
No reviews yet
Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.
It passed 4 of 5 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.
You need to fill in: Authorization, MINERYIELD_API_KEY
Either way works: install it on your computer or connect to the cloud version.
The GitHub repo last changed 9 days ago, and the latest version (1.0.2) reached the registry 9 days ago.
Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. It connects by URL, so apps that accept remote MCP servers work too, such as ChatGPT on the web (full MCP on Business and above; Pro read-only).
In the same category: SolidInvoice, Journalit, Beancount.io, Tapetide - Indian Stock Market MCP, Twelve Data
Same category, other makers, commands already checked. Official ones first, then by stars.
Reading a card:↓ Downloads per weeki★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi
Create and send invoices and quotes, manage clients, and track payments in SolidInvoice.
Trading journal in Obsidian. Ask Claude or ChatGPT about your trades; edits are previewed first.
Query, edit, and reconcile a hosted Beancount ledger: BQL, reports, files, and bank imports.
48 tools for ~8,000 NSE & BSE stocks: quotes, screener, financials, filings, FII/DII, options
Real-time and historical market data: stocks, forex, crypto, ETFs, fundamentals and 60+ indicators.
| This one MinerYield | SolidInvoice | Journalit | Beancount.io | Tapetide - Indian Stock Market MCP | Twelve Data | |
|---|---|---|---|---|---|---|
| Runs where | Cloud or install on your computer | Runs in the cloud, nothing to install | Runs in the cloud, nothing to install | Runs in the cloud, nothing to install | Cloud or install on your computer | Runs in the cloud, nothing to install |
| Needs a key | Yes | No | No | No | Yes | No |
| Add with + in Claude | No | No | No | No | No | Yes |
| Basic checks | 4/5 | 4/6 | 4/4 | 4/4 | 5/5 | 4/4 |
| License | MIT | MIT | NOASSERTION | MIT | MIT | – |
| Price | No cost listed in the registry | No cost listed in the registry | No cost listed in the registry | No cost listed in the registry | No cost listed in the registry | No cost listed in the registry |
Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.
MinerYield is for home miners and small businesses with solar and battery in the numbers. This MCP server (and the hosted endpoint at https://mineryield.com/mcp) exposes the same leftover-watt solar / battery / grid model the site calculator already uses. Tools call https://mineryield.com/api/v1/**. They do not reimplement profitability math.
Ask an assistant:
list_miners answers the first (optional solarW=10000, batteryCapacity=20, sort PROFIT/DAY). calculate_profitability answers the second (power=3000, elecCost=0.15, powerSources={solar:true, battery:false, grid:true}).
Figures are model estimates from live market and weather inputs. They are estimates only, not investment, financial, or tax advice, not ROI guarantees, and not hardware telemetry. Results vary with network difficulty, coin price, power cost, and hardware performance. Do your own research.
Admin routes (/api/v1/admin/*) are not exposed.
Requirements: Node.js 22 or newer.
Hosted endpoint: https://mineryield.com/mcp (Streamable HTTP, Authorization: Bearer ). Setup page: mineryield.com/ai/.
Registry name: io.github.nadeaup/mineryield-mcp
No new calculation logic. These are the site calculator inputs the tools already forward:
| Input | Units | Meaning |
|---|---|---|
solarW | Watts (10000 = 10 kW) | Array capacity. Solar generation is treated as free during the Peak Sun Hours window. |
batteryCapacity | kWh (20 = 20 kWh) | Storage. Excess daytime solar charges it; it covers night hours before grid. |
zipCode | 5-digit US ZIP | Peak Sun Hours. Defaults to the API-key owner profile, then a server default. |
elecCost | USD / kWh (0.15 = 15 cents) | One leftover-grid rate. There is no separate day/night tariff: solar covers the sun window, leftover night kWh use this price when grid is on. |
powerSources | { solar, battery, grid } | Which legs to use. solar + grid + battery:false is "solar by day, grid at night". grid:false means the miner only runs while solar or battery energy lasts (runtimeHours < 24). |
On GET /api/v1/miners / list_miners, query values override the API-key owner profile. Sending solarW without solar=false turns solar on; sending batteryCapacity without battery=false turns battery on.
get_solar_forecast is weather-based array production only (zipCode + capacityW). Pair it with list_miners or calculate_profitability for miner profit.
Create a Bearer API key while signed in at mineryield.com/api with a verified email (create/list/revoke/rotate use a Firebase ID token; email_not_verified → 403). Set it as MINERYIELD_API_KEY. Never commit it.
Optional: MINERYIELD_API_BASE_URL (defaults to https://mineryield.com).
Setup walkthrough: Use MinerYield in your AI assistant.
export MINERYIELD_API_KEY="your-key"
npx -y mineryield-mcp
Local Streamable HTTP (for debugging a hosted-style client):
npx -y mineryield-mcp --http --port 3333
npm install -g mineryield-mcp
export MINERYIELD_API_KEY="your-key" mineryield-mcp
From this repository:
npm install
npm run build export MINERYIELD_API_KEY="your-key" npm start
Add to claude_desktop_config.json (Claude → Settings → Developer):
{
"mcpServers": { "mineryield": { "command": "npx", "args": ["-y", "mineryield-mcp"], "env": { "MINERYIELD_API_KEY": "your-key" } } } }
Or connect Claude to the hosted endpoint https://mineryield.com/mcp with Authorization: Bearer your-key.
This repository also ships .cursor-plugin/plugin.json and a root mcp.json (runs npx -y mineryield-mcp).
Published package / npx snippet for Cursor MCP settings:
{
"mcpServers": { "mineryield": { "command": "npx", "args": ["-y", "mineryield-mcp"], "env": { "MINERYIELD_API_KEY": "your-key" } } } }
Hosted Streamable HTTP:
{
"mcpServers": { "mineryield": { "url": "https://mineryield.com/mcp", "headers": { "Authorization": "Bearer your-key" } } } }
Use Streamable HTTP:
https://mineryield.com/mcpAuthorization: Bearer https://mineryield.com/.well-known/mcp.jsonChatGPT (Connectors / custom MCP), Claude remote MCP, and Grok custom connectors all accept that URL plus the Bearer header. Private tools require a Bearer key. A small keyless catalog subset (list_catalog_miners, list_mrr_rates, list_nicehash_rates, get_market_data plus initialize/tools/list/ping) shares 20/UTC minute and 200/UTC day (Firestore, not per IP). Quota denial never falls back to anonymous.
OpenAPI remains the HTTP contract: mineryield.com/swagger.yaml.
list_catalog_miners, list_mrr_rates, list_nicehash_rates, get_market_data (+ initialize / tools/list / ping).email_not_verified; over quota → 429 {"error":"Quota Exceeded","code":"quota_exceeded","remaining","limit","resetAt","retryAfterSeconds","period"} with Retry-After / RateLimit-* headers.| Tool | HTTP | Auth | Purpose |
|---|---|---|---|
list_miners | GET /api/v1/miners | Bearer API key | Rank catalog ASICs by daily profit for a home/small-business solar+battery+grid setup. Optional solarW, batteryCapacity, zipCode, elecCost, powerSources override the key-owner profile. Same SKUs as the UI, including KDA/NEXA/XP/ALEO/ALPH. |
get_rigs | GET /api/v1/rigs | Bearer API key | Saved My Rigs plus per-unit estimates (includes NiceHash daily revenue when a rate exists) |
calculate_profitability | POST /api/v1/calculator | Bearer API key | One-machine leftover-watt model (algorithm catalog names include Kadena, NexaPow, XPHash; SHA-256 preferredCoin may be QUAI) |
get_market | GET /api/v1/market | Bearer API key | Live spot prices (BTC, BCH, LTC, DOGE, ZEC, KAS, CKB, RXD, SC, DCR, DASH, GRIN, ALPH, XTM, ETC, XMR, ALEO, HNS, BTCB2, KDA, NEXA, XP, QUAI, ARRR, OCTA, ETHW, QKC, MWC, SCP) |
get_solar_forecast | GET /api/v1/solar-forecast | Bearer API key | 7-day solar production estimate (zipCode, capacityW) |
get_difficulty_prediction | GET /api/v1/difficulty-prediction | Bearer API key | 7-day difficulty trend (coin, default BTC; allowlist is the supported market symbol set) |
list_catalog_miners | GET /api/v1/catalog/miners | Public | Specs-only ASIC catalog (Kadena, NexaPow, XPHash, ALEO, ALPH, SHA-256 QUAI-capable SKUs). Goldshell HS-Lite is one row with dual modes (Blake2B-SHA3/HNS and Blake2B SC/BTCB2). |
list_mrr_rates | GET /api/v1/mrr-rates | Public | Cached Mining Rig Rentals algorithm rates. NexaPow maps to nexapow. SHA3X, zkSNARK, Blake256R14, Kadena, and XPHash have no primary book. |
list_nicehash_rates | GET /api/v1/nicehash-rates | Public | Cached NiceHash paying rates (sat/H/day). SHA3X, zkSNARK, Blake256R14, Kadena, and XPHash have no NiceHash book. |
get_market_data | GET /api/v1/market-data | Public | Full market payload used by the web app (includes KDA/NEXA/XP/QUAI/ARRR/OCTA/ETHW/QKC/MWC/SCP prices + nethash/difficulty; new-coin and XP fields may be omitted) |
calculate_profitability bodyMatches POST /api/v1/calculator in the OpenAPI spec:
| Field | Required | Notes |
|---|---|---|
hashrate | yes | Catalog units (TH/s for SHA-256 and Kadena, GH/s for NexaPow and XPHash, MH/s for Scrypt) |
power | yes | Watts (3000 = 3 kW) |
algorithm | yes | Catalog name (SHA-256, Scrypt, Kadena, NexaPow, XPHash, KHeavyHash, …) |
elecCost | yes | USD / kWh leftover-grid rate |
solarW | no | Array watts |
zipCode | no | 5-digit US ZIP for Peak Sun Hours |
hardwareCost | no | USD, used for estimated payback days |
batteryCapacity | no | kWh |
powerSources | no | { solar, battery, grid } booleans |
preferredCoin | no | e.g. BTC/BCH/QUAI, SC/BTCB2, BTCB2/SC, ZEC/ARRR, ETC/OCTA/ETHW/QKC, DCR/SCP. Blake2B-SHA3 is HNS only; Cuckatoo31 is MWC only; Cuckatoo32 is GRIN only. Scrypt reports LTC/DOGE (merged). When omitted, the most profitable supported coin is used except Ethash4G, which defaults to ETC. |
GET / POST / DELETE /api/v1/api-keys require a Firebase ID token from a signed-in browser session, not the Bearer API key. Creating or revoking keys from an agent is not part of this default tool set. Use the site at /api.
npm install
npm test
Publish npm first, then the official MCP Registry.
package.json and server.json (including packages[0].version). mcpName / name stay io.github.nadeaup/mineryield-mcp.npm publish from a trusted machine (runs npm run build via prepublishOnly).v* tag, create a GitHub Release, or run Actions → Publish to MCP Registry on main. That workflow uses GitHub OIDC (mcp-publisher login github-oidc); it does not need a personal GitHub token and does not republish npm.If the Registry already has that version, the workflow treats it as success. See RELEASING.md.
Production endpoint: https://mineryield.com/mcp
Bearer API-key auth uses the same key store as /api/v1 for private tools. Admin routes and tools are not mounted. Keyless catalog subset uses the shared 20/min + 200/day anonymous budget. Per-key and per-address rate limits apply for authenticated traffic; keyed tool calls consume the rolling REST quota (25 free / paid tiers above).
Discovery:
/mcp-discovery.json)