Skip to main content
Glama
Satstream MCP Server

Satstream MCP Server

Official
by satstream

Satstream MCP Server

A Model Context Protocol (MCP) server that provides access to Satstream Bitcoin data API.

Setup

To install dependencies:

bun install

To run with an API key:

export SATSTREAM_API_KEY="your-api-key-here"
bun run index.ts

Or pass the API key as a command line argument:

bun run index.ts your-api-key-here

Related MCP server: MCP Blockchain Query Server

About Satstream

Satstream is a comprehensive Bitcoin blockchain API service that provides access to real-time blockchain data, including transactions, addresses, blocks, and specialized data like Ordinals inscriptions and Runes tokens.

Getting an API Key

To use this MCP server, you'll need a Satstream API key. You can obtain one by:

  1. Visiting Satstream Documentation

  2. Signing up for an account

  3. Generating an API key from your dashboard

The free tier provides access to basic functionality with rate limits, while paid plans offer higher rate limits and additional features.

Available MCP Functions

The following MCP functions are available for Bitcoin data queries:

Address Functions

Function Name

Description

Parameters

address_get

Get detailed information about a Bitcoin address

address: Bitcoin address

address_balance_get

Get balance for a Bitcoin address

address: Bitcoin address

address_deltas_get

Get transaction history for an address

address: Bitcoin address, plus optional pagination params

address_validate

Validate a Bitcoin address

address: Bitcoin address

address_outputs_get

Get UTXOs for a Bitcoin address

address: Bitcoin address, type: Optional UTXO type filter

address_rune_deltas_get

Get rune token history for an address

address: Bitcoin address, plus optional pagination params

Blockchain Functions

Function Name

Description

Parameters

block_get

Get information about a block by hash or height

identifier: Block hash or height

blockchain_info

Get current blockchain stats and network info

random_string: Optional dummy parameter

transaction_get

Get details about a transaction

txid: Transaction ID

Mempool Functions

Function Name

Description

Parameters

mempool_info_get

Get mempool statistics

random_string: Optional dummy parameter

mempool_transactions_get

List unconfirmed transactions

Optional pagination params

Ordinals and Runes Functions

Function Name

Description

Parameters

ordinals_inscription_get

Get data about an ordinals inscription

inscription_id: Inscription ID

rune_get

Get information about a specific rune

identifier: Rune name or ID

runes_latest_get

Get latest runes (first 100)

random_string: Optional dummy parameter

runes_page_get

Get a specific page of runes

page: Page number

Usage Examples

Get address information

address_get({ address: "1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa" })

Validate a Bitcoin address

address_validate({ address: "1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa" })

Get block information

block_get({ identifier: "000000000019d6689c085ae165831e934ff763ae46a2a6c172b3f1b60a8ce26f" })

Get blockchain stats

blockchain_info({ random_string: "dummy" })

Get address balance

address_balance_get({ address: "1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa" })

Get UTXOs for an address, filtered by type

address_outputs_get({ 
  address: "1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa",
  type: "cardinal"
})

Get information about a specific rune

rune_get({ identifier: "UNCOMMON•GOODS" })

Get latest runes

runes_latest_get({ random_string: "dummy" })

MCP Integration

This server is designed to be used with Cursor or other environments supporting the Model Context Protocol. For detailed function descriptions and usage guidelines, see function-descriptions.json.

This project was created using Bun, a fast all-in-one JavaScript runtime.

Available Tools

37 tools
address_balance_getA

Get the total Bitcoin balance (in satoshis) of an address by summing all its deltas. Use this when you only need the balance information without the full address details.

Inputs: address (required).

address_deltas_getA

Get transaction deltas (inputs and outputs) for a specific Bitcoin address with pagination. Use this to analyze the transaction history of an address with filtering by block height.

Inputs: address (required), cursor, page_size, end_height, +1 more.

address_getA

Get detailed information about a specific Bitcoin address, including transaction history and UTXO details. Use this when you need comprehensive data about an address.

Inputs: address (required).

address_outputs_getA

Retrieve UTXOs (unspent transaction outputs) held by a specific Bitcoin address with optional type filtering. Use this to get detailed information about available UTXOs for spending or analysis.

Inputs: address (required), type.

address_rune_deltas_getA

Get rune deltas (changes in rune balances) for a specific Bitcoin address with pagination. Use this to analyze the history of rune token transfers for an address.

Inputs: address (required), cursor, page_size, end_height, +1 more.

address_validateA

Validate a Bitcoin address and retrieve information about its format, type, and validity. Use this to check if an address is valid before sending or receiving transactions.

Inputs: address (required).

blockchain_infoA

Get current blockchain information including chain height, latest block details, and network status. Use this for obtaining overall Bitcoin network statistics.

Inputs: random_string.

block_count_getC

Get the current block height of the Bitcoin blockchain. This returns the height of the latest block that has been processed.

Inputs: random_string.

block_getA

Get detailed information about a specific Bitcoin block by its hash or height. Use this to retrieve block header data, transaction IDs, and mining details.

Inputs: identifier (required).

blockhash_by_height_getB

Get the hash of a specific Bitcoin block by its height. Use this to convert a block height to its corresponding block hash.

Inputs: block_height (required).

block_raw_decoded_getA

Get the full decoded (verbose) representation of a specific Bitcoin block by its hash or height. This provides extensive details about the block structure and contained transactions.

Inputs: identifier (required).

block_raw_hex_getA

Get the raw hexadecimal representation of a specific Bitcoin block by its hash or height. This provides the complete serialized block data in hexadecimal format.

Inputs: identifier (required).

block_raw_prevout_getA

Get the full decoded representation of a specific Bitcoin block with prevout information by its hash or height. This provides extensive details about the block including input and output data.

Inputs: identifier (required).

block_raw_summary_getA

Get a summary of a specific Bitcoin block by its hash or height. This provides a condensed view of block data without full transaction details.

Inputs: identifier (required).

blocks_getA

Get information about the last 100 Bitcoin blocks. Use this for obtaining an overview of recent blockchain activity including block heights, hashes, and timestamps.

Inputs: random_string.

inscription_child_getA

Get information about a specific child of a Bitcoin Ordinals inscription. Use this to retrieve metadata about nested or child inscriptions.

Inputs: child_index (required), inscription_id (required).

inscriptions_block_getA

Get all Bitcoin Ordinals inscriptions in a specific block. Use this to analyze the inscriptions created in a particular block height.

Inputs: block_height (required).

inscriptions_block_page_getA

Get a specific page of Bitcoin Ordinals inscriptions in a particular block. Use this for paginated access to the inscriptions created in a specific block height.

Inputs: page (required), block_height (required).

inscriptions_latest_getC

Get the latest Bitcoin Ordinals inscriptions. Use this to retrieve recently created NFT-like inscriptions on the Bitcoin blockchain.

Inputs: random_string.

inscriptions_page_getB

Get a specific page of Bitcoin Ordinals inscriptions. Use this for paginated access to the complete list of inscriptions on the blockchain.

Inputs: page (required).

latest_blockhash_getC

Get the hash of the latest block in the Bitcoin blockchain. Use this to retrieve the most recent block hash.

Inputs: random_string.

latest_block_height_getB

Get the current height of the Bitcoin blockchain. This returns the height of the latest block that has been processed.

Inputs: random_string.

latest_blocktime_getB

Get the timestamp of the latest block in the Bitcoin blockchain. This returns the UNIX timestamp of when the latest block was mined.

Inputs: random_string.

mempool_info_getB

Get current Bitcoin mempool statistics including size, transaction count, and fee estimates. Use this to understand the current state of unconfirmed transactions.

Inputs: random_string.

mempool_transactions_getB

List unconfirmed transactions in the Bitcoin mempool with pagination. Use this to monitor incoming transactions before they are included in a block.

Inputs: cursor, page_size.

ordinals_inscription_getA

Get information about a specific Bitcoin Ordinals inscription by its ID. Use this to retrieve metadata about NFT-like inscriptions on Bitcoin, including content type and ownership details.

Inputs: inscription_id (required).

output_getA

Get detailed information about a specific Bitcoin UTXO (unspent transaction output) by its outpoint in the format 'txid:vout'. Use this to retrieve spend status, value, and script details of an output.

Inputs: outpoint (required).

rune_getA

Retrieve information about a specific Bitcoin Rune by name or ID (e.g., "UNCOMMON•GOODS" or "1:0"). Use this to get details about a specific rune token, including supply, minting status, and transactions.

Inputs: identifier (required).

runes_latest_getA

Retrieve information about the last 100 inscribed Bitcoin Runes (first page). Use this to get an overview of the most recently created rune tokens on the Bitcoin blockchain.

Inputs: random_string.

runes_page_getB

Retrieve a specific page of 100 inscribed Bitcoin Runes. Use this for paginated access to the complete list of rune tokens on the blockchain.

Inputs: page (required).

sat_getA

Get information about a specific satoshi by its absolute number (index). Use this to retrieve details about a particular satoshi, including its rarity, block of creation, and inscription status.

Inputs: number (required).

status_getA

Get the current status of the Satstream API server, including uptime, version information, and performance metrics. Use this to check if the API is functioning properly.

Inputs: random_string.

transaction_getA

Get detailed information about a specific Bitcoin transaction by its transaction ID (txid). Use this to retrieve comprehensive data about inputs, outputs, fees, and confirmation status.

Inputs: txid (required).

tx_inscriptions_getA

Get all Bitcoin Ordinals inscriptions contained in a specific transaction. Use this to analyze the inscriptions created or transferred in a particular transaction.

Inputs: txid (required).

tx_raw_decode_getB

Get a raw Bitcoin transaction with basic decoded information by its transaction ID. This provides the transaction structure and decoded script data.

Inputs: txid (required).

tx_raw_hex_getA

Get the raw hexadecimal representation of a Bitcoin transaction by its transaction ID. This provides the complete serialized transaction data in hexadecimal format.

Inputs: txid (required).

tx_raw_prevout_getB

Get a raw Bitcoin transaction with prevout information by its transaction ID. This provides the transaction with details about the previous outputs being spent.

Inputs: txid (required).

Tool Schema Changelog

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

Loading tool schema changelog…

    TDQS

    B3.3/5.0

    Scored across 37 tools

    Disambiguation3/5

    Many tools have distinct purposes, but there is significant overlap among multiple block retrieval tools (block_get, block_raw_decoded_get, block_raw_hex_get, etc.) and inscription tools, which could confuse an agent despite clear descriptions.

    Naming Consistency5/5

    All tool names follow a consistent noun_verb or noun_get pattern in snake_case, with no camelCase or mixed conventions. Singular and plural forms are used predictably.

    Tool Count2/5

    With 37 tools, the count exceeds the 25+ threshold described as 'too many'. While the domain is broad, several tools are redundant variants (e.g., multiple block detail levels), making the set feel bloated.

    Completeness4/5

    The tools cover address data, blocks, inscriptions, runes, transactions, mempool, and status thoroughly. Missing transaction creation/signing, but for a read-only data API this is nearly complete. Minor gap: no fee estimation.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers