Ss MCP

The Satstream MCP server is a Model Context Protocol service that provides API access to Bitcoin blockchain data, supporting queries for Bitcoin-related data such as addresses, blocks, transactions, and Runes.

Finance Developer tools #Bitcoin API #Blockchain Data #MCP Service #Runes Query .TypeScript

rating : 2 points

downloads : 4

update time : 2025-04-29

What is Satstream MCP Server?

Satstream MCP Server is a Bitcoin blockchain data interface server that provides access to Bitcoin blockchain data through the Model Context Protocol (MCP). It can query address information, transaction records, block data, and specialized data such as Ordinals inscriptions and Runes tokens.

How to use Satstream MCP Server?

You need to obtain an API key before use, and then start the server with simple commands. It supports passing the API key via environment variables or command-line parameters.

Use Cases

It is suitable for application development that requires real-time Bitcoin blockchain data, including wallet services, block explorers, transaction analysis tools, etc.

Main Features

Address FunctionsQuery detailed information, balance, transaction history, and UTXO of Bitcoin addresses, etc.

Blockchain FunctionsGet block information and current blockchain statistical data

Mempool FunctionsQuery unconfirmed transactions and mempool statistical information

Ordinals and Runes FunctionsQuery Bitcoin Ordinals inscriptions and Runes token data

Advantages and Limitations

Advantages

Provide comprehensive access to Bitcoin blockchain data

Support emerging Bitcoin protocols such as Ordinals and Runes

Simple and easy-to-use API interface

Based on the high-performance Bun runtime

Limitations

The free version has API call frequency limits

An API key is required for use

Currently only supports Bitcoin data

How to Use

Get an API Key

Visit the Satstream website to register an account and obtain an API key

Install Dependencies

Use the Bun package manager to install project dependencies

Start the Server

Start the server by passing the API key via environment variables or command-line parameters

Usage Examples

Query Address BalanceGet the current balance of a specified Bitcoin address

Validate a Bitcoin AddressCheck if a string is a valid Bitcoin address

Query Ordinals InscriptionsGet detailed information of specific Ordinals inscriptions

Frequently Asked Questions

How to get an API key?

What are the limitations of the free version?

Which programming languages are supported for calls?

What is the data update frequency?

Related Resources

Satstream Official Website

The official website of Satstream

Satstream Documentation

Detailed API documentation and usage guides

Bun Runtime

The JavaScript runtime used in the project

Bitcoin Developer Documentation

Basic knowledge of Bitcoin development

🚀 Satstream MCP Server

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

🚀 Quick Start

📦 Installation

To install the dependencies:

bun install

Run with an API key:

export SATSTREAM_API_KEY="your_API_key"
bun run index.ts

Or pass the API key via command-line argument:

bun run index.ts your_API_key

✨ Features

About Satstream

Satstream is a comprehensive Bitcoin blockchain data interface service that offers real-time blockchain data access, including transactions, addresses, blocks, and specialized data such as ordinal inscriptions and rune tags.

Obtain an API Key

To use this MCP server, you need a Satstream API key. You can obtain it by following these steps:

Visit Satstream Documentation.
Register an account.
Generate an API key from your dashboard.

The free tier provides basic features and rate limits, while paid plans offer higher rate limits and more 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 the balance of a Bitcoin address	`address`: Bitcoin address
`address_deltas_get`	Get the transaction history of an address	`address`: Bitcoin address, optional pagination parameters
`address_validate`	Validate a Bitcoin address	`address`: Bitcoin address
`address_outputs_get`	Get the UTXO information of an address	`address`: Bitcoin address, `type`: optional UTXO type filter
`address_rune_deltas_get`	Get the rune tag history of an address	`address`: Bitcoin address, optional pagination parameters

Blockchain Functions

Function Name	Description	Parameters
`block_get`	Get block information by hash or height	`identifier`: Block hash or height
`blockchain_info`	Get current blockchain statistics and network information	`random_string`: optional placeholder parameter
`transaction_get`	Get detailed information about a transaction	`txid`: Transaction ID

Mempool Functions

Function Name	Description	Parameters
`mempool_info_get`	Get mempool statistics	`random_string`: optional placeholder parameter
`mempool_transactions_get`	List unconfirmed transactions	Optional pagination parameters

Ordinal and Rune Tag Functions

Function Name	Description	Parameters
`ordinals_inscription_get`	Get the data of an ordinal inscription	`inscription_id`: Inscription ID
`rune_get`	Get information about a specific rune tag	`rune`: Rune tag content
`rune_deltas_get`	Get the latest changes of all rune tags	No parameters

💻 Usage Examples

This server is designed to work with Cursor or other environments that support the Model Context Protocol. For function descriptions and usage guides, see function-descriptions.json.

This project is created with Bun, a fast all-in-one JavaScript runtime environment.