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

Blockchain Functions

Mempool Functions

Ordinals and Runes Functions

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.