The Satstream MCP Server provides comprehensive access to real-time Bitcoin blockchain data through the Satstream API, with capabilities including:
- Bitcoin Address Data: Retrieve balance information, transaction history, UTXOs, and validate addresses
- Blockchain Information: Access block details by hash or height, raw and decoded block data, and network statistics
- Transaction Data: Get transaction details including raw, decoded, and prevout data
- Mempool Monitoring: View statistics and unconfirmed transactions in real-time
- Ordinals & Inscriptions: Fetch data about Ordinals inscriptions, including latest, paginated lists, and child inscriptions
- Runes Tokens: Access information about Runes by name or ID, with listing options
- UTXO Analysis: Retrieve and filter unspent outputs by various types (cardinal, inscribed, runic)
- Satoshi Tracking: Get information about specific satoshis by their index
- Advanced Features: Support for pagination, raw data retrieval, and server status monitoring
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:
To run with an API key:
Or pass the API key as a command line argument:
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:
- Visiting Satstream Documentation
- Signing up for an account
- 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
Validate a Bitcoin address
Get block information
Get blockchain stats
Get address balance
Get UTXOs for an address, filtered by type
Get information about a specific rune
Get latest runes
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.
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.
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.
Related MCP Servers
- AsecurityAlicenseAqualityA Model Context Protocol server that provides read-only access to Bybit's cryptocurrency exchange API, allowing users to query real-time cryptocurrency data using natural language.Last updated -9149TypeScriptMIT License
- -securityFlicense-qualityA Model Context Protocol server providing tools for querying Bitcoin blockchain data via Blockchain Data and Query APIs, supporting various BTC information retrieval functions.Last updated -Python
- -securityFlicense-qualityA Model Context Protocol server that enables AI assistants to access Flow blockchain data and perform operations such as checking balances, resolving domains, executing scripts, and submitting transactions.Last updated -JavaScript
- -securityAlicense-qualityA production-ready Model Context Protocol server implementation that connects AI assistants to the TON blockchain, allowing them to query wallet balances, transaction details, smart contracts, and other blockchain data.Last updated -TypeScriptMIT License