About Satstream MCP Server
Satstream MCP Server exposes the Satstream Bitcoin blockchain API to MCP-capable environments for users querying on-chain data. Its tools cover addresses, blocks, transactions, the mempool, Ordinals inscriptions, and Runes.
Key features
- 01Query addresses, balances, history, and UTXOs
- 02Validate Bitcoin addresses
- 03Retrieve block and transaction details
- 04Query blockchain and mempool data
- 05Look up Ordinals inscriptions and Runes
Use cases
- 01Check an address balance and transaction history
- 02Retrieve block details by height or hash
- 03Inspect unconfirmed transactions and mempool statistics
- 04Look up inscription or Rune information
MCP support
The server exposes Satstream API tools for Bitcoin data queries to Cursor and other MCP-capable environments. It requires SATSTREAM_API_KEY.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.
Tools
Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.
Details
From the project READMESatstream 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:
- 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
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.
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.