Stampchain

You run a Stampchain MCP Server to query Bitcoin Stamps, stamp collections, and SRC-20 tokens through the Stampchain API. It provides a stable, type-safe interface for MCP clients to access up-to-date stamp data and token information, enabling you to build tooling and integrations without direct API calls.

How to use

You connect to the MCP server using an MCP-compatible client. The server supports standard MCP protocol over stdio, so you launch a local MCP process or point a client at a remote MCP endpoint as described in the configuration. Your client can request stamp details, search stamps and collections, and retrieve SRC-20 token information. Use the client’s normal workflow to perform actions like getting a specific stamp, listing recent stamps, or searching tokens.

Key actions you can perform include querying Bitcoin Stamps with get_stamp and search_stamps, retrieving recent stamps with get_recent_stamps, fetching collection data with get_collection and search_collections, and obtaining SRC-20 token information with get_token_info and search_tokens.

How to install

# Prerequisites
node -v
npm -v
# Node.js 18+ is required

# Step 1: Install dependencies (example flow if you clone a repo)
git clone https://github.com/stampchain-io/stampchain-mcp.git
cd stampchain-mcp

# Step 2: Install dependencies
npm install

# Step 3: Build the project
npm run build

# Step 4: Start the server
npm run start

Configuration and startup notes

Configure the MCP server so clients can connect using the desired transport. The server supports both local stdio execution and remote HTTP connections. When using a local stdio setup, provide the exact command to run the MCP server and any necessary arguments.

{
  "mcpServers": {
    "stampchain": {
      "type": "stdio",
      "name": "stampchain",
      "command": "node",
      "args": ["/path/to/stampchain-mcp/dist/index.js"],
      "cwd": "/path/to/stampchain-mcp"
    }
  }
}

Available tools

get_stamp

Fetches detailed information about a specific stamp by its ID.

search_stamps

Searches stamps with filters such as creator, collection, and other attributes.

get_recent_stamps

Retrieves the most recently created stamps.

get_collection

Fetches detailed information about a specific stamp collection.

search_collections

Searches collections with various filters.

get_token_info

Retrieves detailed information about a specific SRC-20 token.

search_tokens

Searches SRC-20 tokens using multiple filters.