get_stampLABSCO SUMMARY
Bitcoin Stamps data, addressable in conversation.
Stamps and SRC-20 tokens live behind an API that rewards knowing its shape; this puts stamp, collection and token lookups one question away. It reads — nothing here mints, transfers or spends.
What it is
A TypeScript MCP server over the Stampchain API v2.3, giving a client read access to Bitcoin Stamps, stamp collections and SRC-20 token data.
What you get
- Details for a single stamp, and a feed of the most recently created stamps
- Search across stamps when you know a trait or a term but not the stamp number
- Collection lookup and collection search, for working at the set level rather than the item level
- SRC-20 token information and token search
- Inputs validated with Zod, so a malformed request fails at the boundary rather than downstream
Requirements
Node.js 18 or newer; no key is mentioned for the Stampchain API. It runs from a local build, on Ubuntu, Windows and macOS. The README's npm line names stampchain-mcp, which npm does not have.
Setup effort
Build from source — git clone https://github.com/stampchain-io/stampchain-mcp.git
USE CASES
01
Checking what a specific stamp actually is
Pull the record for one stamp number and see its details rather than trusting a marketplace listing.
02
Seeing what has just been stamped
Read the most recent stamps to follow activity without refreshing an explorer.
03
Finding stamps you can only half describe
Search by term when you remember something about a stamp but not its number.
04
Working out what a collection contains
Look up a collection directly, or search collections when you are not sure of the exact name.
05
Researching an SRC-20 token
Get the token's information, or search the token set when you are comparing several tickers.
7 tools
Listed in project docs. Your client may show a different list.
search_stampsget_recent_stampsget_collectionsearch_collectionsget_token_infosearch_tokensBEFORE YOU INSTALL
What to know first
Tools you get
7 tools named in the project's documentation.
Requires
Node.js 18+
Where it runs
The documented client runs the server on your machine.
INSTALLATION
Connect your client
You clone and build this one yourself.
Server setup
TERMINAL
git clone https://github.com/stampchain-io/stampchain-mcp.git
cd stampchain-mcp
npm install
npm run buildMCP Clients
Claude Desktop
CLAUDE DESKTOP · JSON
{
"mcpServers": {
"stampchain": {
"command": "node",
"args": [
"<YOUR_PATH_TO_STAMPCHAIN_MCP>/dist/index.js"
],
"cwd": "<YOUR_PATH_TO_STAMPCHAIN_MCP>"
}
}
}
