Satstream MCP Server

Official
by satstream
Verified

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

  • Provides comprehensive access to Bitcoin blockchain data, including address information, balances, transaction history, block details, mempool statistics, and support for Bitcoin-specific features like Ordinals inscriptions and Runes tokens.

  • The server is built using Bun as its JavaScript runtime environment, allowing for fast execution of the MCP server that interfaces with the Bitcoin data API.

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

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 NameDescriptionParameters
address_getGet detailed information about a Bitcoin addressaddress: Bitcoin address
address_balance_getGet balance for a Bitcoin addressaddress: Bitcoin address
address_deltas_getGet transaction history for an addressaddress: Bitcoin address, plus optional pagination params
address_validateValidate a Bitcoin addressaddress: Bitcoin address
address_outputs_getGet UTXOs for a Bitcoin addressaddress: Bitcoin address, type: Optional UTXO type filter
address_rune_deltas_getGet rune token history for an addressaddress: Bitcoin address, plus optional pagination params

Blockchain Functions

Function NameDescriptionParameters
block_getGet information about a block by hash or heightidentifier: Block hash or height
blockchain_infoGet current blockchain stats and network inforandom_string: Optional dummy parameter
transaction_getGet details about a transactiontxid: Transaction ID

Mempool Functions

Function NameDescriptionParameters
mempool_info_getGet mempool statisticsrandom_string: Optional dummy parameter
mempool_transactions_getList unconfirmed transactionsOptional pagination params

Ordinals and Runes Functions

Function NameDescriptionParameters
ordinals_inscription_getGet data about an ordinals inscriptioninscription_id: Inscription ID
rune_getGet information about a specific runeidentifier: Rune name or ID
runes_latest_getGet latest runes (first 100)random_string: Optional dummy parameter
runes_page_getGet a specific page of runespage: 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.

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

A Model Context Protocol server that enables querying Bitcoin blockchain data, including address information, transaction details, mempool statistics, and ordinals/runes data through the Satstream API.

  1. Setup
    1. About Satstream
      1. Getting an API Key
    2. Available MCP Functions
      1. Address Functions
      2. Blockchain Functions
      3. Mempool Functions
      4. Ordinals and Runes Functions
    3. Usage Examples
      1. Get address information
      2. Validate a Bitcoin address
      3. Get block information
      4. Get blockchain stats
      5. Get address balance
      6. Get UTXOs for an address, filtered by type
      7. Get information about a specific rune
      8. Get latest runes
    4. MCP Integration
      ID: oumg0xfft3