Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Connect AI agents to Minerstat

Scalekit connector
Open markdown

The Minerstat connector lets your AI agent act in each user's Minerstat account. Each user connects their own Minerstat API key once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 10 tools.

Tools
10
What they doRead · write · destructive
10 · 0 · 010 read0 write0 destructive
Users sign in with

Setup

  1. Install the SDK

    Terminal window
    npm install @scalekit-sdk/node dotenv
  2. Set your credentials

    Add your Scalekit credentials to your .env file. Find values in app.scalekit.com > Developers > API Credentials.

    .env
    SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
    SCALEKIT_CLIENT_ID=<your-client-id>
    SCALEKIT_CLIENT_SECRET=<your-client-secret>
  3. Create the Minerstat connection

    In AgentKit > Connections, create a Minerstat connection. The name you give it is the connection_name your code passes. See Configure connections.

  4. Authorize a user and make your first call

    quickstart.mts
    import { ScalekitClient } from '@scalekit-sdk/node'
    import 'dotenv/config'
    import { createInterface } from 'node:readline/promises'
    const scalekit = new ScalekitClient(
    process.env.SCALEKIT_ENVIRONMENT_URL,
    process.env.SCALEKIT_CLIENT_ID,
    process.env.SCALEKIT_CLIENT_SECRET,
    )
    const actions = scalekit.actions
    const connector = 'minerstat'
    const identifier = 'user_123'
    // Generate an authorization link for the user
    const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
    console.log('Authorize Minerstat:', link)
    const rl = createInterface({ input: process.stdin, output: process.stdout })
    await rl.question('Press Enter after authorizing...')
    rl.close()
    // Make your first call
    const result = await actions.executeTool({
    connector,
    identifier,
    toolName: 'minerstat_algorithms_list',
    toolInput: {},
    })
    console.log(result)
    Terminal window
    npx tsx quickstart.mts

    Each user opens the link once and enters their Minerstat credentials there. See Authorize a user for the full flow and statuses.

Tools

Pass the exact name to execute_tool
Try in PlaygroundRequest a tool
  • minerstat_algorithm_getGet one mining algorithm by slug, with the coins that use it and the hardware that supports it.Read-only

    Get Algorithm

    Get one mining algorithm by slug, with the coins that use it and the hardware that supports it. Returns the algorithm with its coins[] and hardware[] lists. Use this when you know the algorithm slug. Use List Algorithms to find it.

    Inputs

    slugstringrequired
    Minerstat algorithm slug, from List Algorithms. Example: sha256.
  • minerstat_algorithms_listList proof-of-work mining algorithms.Read-only

    List Algorithms

    List proof-of-work mining algorithms. Returns results[] with each algorithm's slug, name and counts of coins and hardware benchmarks. Use this to find an algorithm slug. Use Get Algorithm for its coins and hardware.

    Inputs

    limitinteger
    Maximum algorithms to return. Capped by plan: 20 on Free, 500 on Developer, 1,000 on Enterprise. Example: 50.
    offsetinteger
    Rows to skip, for paging together with limit. Example: 50.
  • minerstat_coin_getGet one coin by slug, with every list field plus website, block explorer, consensus type and supply.Read-only

    Get Coin

    Get one coin by slug, with every list field plus website, block explorer, consensus type and supply. Returns generatedAt, dataUpdatedAt, confidence and a coin object. Use this when you know the coin slug. Use List Coins to find it.

    Inputs

    slugstringrequired
    Minerstat coin slug, from List Coins. Example: bitcoin.
  • minerstat_coin_history_listList historical network snapshots for one coin, newest first, up to 100 points per call.Read-only

    List Coin History

    List historical network snapshots for one coin, newest first, up to 100 points per call. Returns snapshots with network hashrate, difficulty, reward and price over time. Use this for trends. Use Get Coin for the current values.

    Inputs

    slugstringrequired
    Minerstat coin slug, from List Coins. Example: bitcoin.
    limitinteger
    Points to return, up to 100 (Free plan: 20). Example: 30.
    offsetinteger
    Points to skip, for paging. Example: 30.
  • minerstat_coins_listList active mineable coins with market, network and data-freshness fields, optionally filtered by algorithm.Read-only

    List Coins

    List active mineable coins with market, network and data-freshness fields, optionally filtered by algorithm. Returns results[] with slug, symbol, name, algorithm, networkHashrate, difficulty, reward, price and confidence, plus offset, limit and count. Use this to find a coin slug. Use Get Coin for one coin's full details.

    Inputs

    algorithmstring
    Algorithm slug to filter by, from List Algorithms. Example: scrypt.
    limitinteger
    Maximum coins to return. Capped by plan: 20 on Free, 500 on Developer, 1,000 on Enterprise. Example: 50.
    offsetinteger
    Rows to skip, for paging together with limit. Example: 50.
    verifiedboolean
    Set true to return only coins with a confidence score of 70 or more. Example: true.
  • minerstat_hardware_getGet one mining device by slug, with release info and the full manufacturer spec sheet.Read-only

    Get Hardware

    Get one mining device by slug, with release info and the full manufacturer spec sheet. Returns a hardware object with slug, name, manufacturer, type, releaseDate, defaultPowerWatts and specs[]. Use this when you know the hardware slug. Use List Hardware to find it.

    Inputs

    slugstringrequired
    Minerstat hardware slug, from List Hardware. Example: nvidia-geforce-rtx-4090.
  • minerstat_hardware_listList mining hardware in the Minerstat catalog, optionally filtered by type.Read-only

    List Hardware

    List mining hardware in the Minerstat catalog, optionally filtered by type. Returns results[] with slug, name, manufacturer, type, power and release date. Use this to find a hardware slug. Use Get Hardware for one device's specs.

    Inputs

    limitinteger
    Maximum devices to return. Capped by plan: 20 on Free, 500 on Developer, 1,000 on Enterprise. Example: 50.
    offsetinteger
    Rows to skip, for paging together with limit. Example: 50.
    typestring
    Hardware type: ASIC, GPU, CPU or FPGA. Example: GPU.one of ASICGPUCPUFPGA
  • minerstat_pool_getGet one mining pool by slug, with per-coin fees, payout schemes and minimum payouts.Read-only

    Get Pool

    Get one mining pool by slug, with per-coin fees, payout schemes and minimum payouts. Returns the pool object with its per-coin entries. Use this when you know the pool slug. Use List Pools to find it.

    Inputs

    slugstringrequired
    Minerstat pool slug, from List Pools. Example: f2pool.