Skip to main content
Glama

Stampchain MCP Server

by stampchain-io
GitHub
TypeScript
  • Apple
  • Linux
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

Stampchain MCP Server

A Model Context Protocol (MCP) server for interacting with Bitcoin Stamps data via the Stampchain API. This server provides tools for querying stamp information, collections, and blockchain data without requiring API authentication.

📋 Table of Contents

🎯 What This MCP Server Provides

  • 🖼️ Stamp Query Tools: Search and retrieve information about Bitcoin Stamps
  • 📦 Collection Explorer: Browse and analyze stamp collections
  • 🪙 Token Information: Access SRC-20 token deployment and minting data
  • 🤖 AI-Powered Integration: Generate code and get development assistance
  • 📡 Real-time Data: Access live Stampchain API data through your IDE

🚀 Quick Start

Prerequisites

  • Node.js 18.0 or higher
  • npm or yarn package manager
  • Claude Desktop, Cursor, Windsurf, or Claude Code IDE

Installation

# Clone and setup in one command git clone https://github.com/stampchain-io/stampchain-mcp && cd stampchain-mcp && npm run setup

This will:

  1. Install all dependencies
  2. Build the project
  3. Automatically configure Claude Desktop (if installed)
Manual Installation
# Clone the repository git clone https://github.com/stampchain-io/stampchain-mcp cd stampchain-mcp # Install dependencies npm install # Build the project npm run build # Configure your IDE (see IDE Configuration section below)
For Development
# Run in development mode with hot reload npm run dev

⚙️ IDE Configuration

The Stampchain MCP server can be configured with various AI-powered IDEs that support the Model Context Protocol. Below are configuration instructions for popular IDEs.

Claude Desktop

Add to your Claude Desktop configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
Linux: ~/.config/claude/claude_desktop_config.json

{ "mcpServers": { "stampchain": { "command": "node", "args": ["/absolute/path/to/stampchain-mcp/dist/index.js"], "env": { "STAMPCHAIN_API_URL": "https://stampchain.io/api/v2", "API_TIMEOUT": "30000", "DEBUG": "stampchain-mcp:*" } } } }
Cursor IDE

Add to your Cursor settings (File > Preferences > Settings > Extensions > MCP):

  1. Open Cursor settings (JSON) by pressing Cmd/Ctrl + Shift + P and selecting "Preferences: Open Settings (JSON)"
  2. Add the MCP configuration:
{ "mcp.servers": { "stampchain": { "command": "node", "args": ["/absolute/path/to/stampchain-mcp/dist/index.js"], "env": { "STAMPCHAIN_API_URL": "https://stampchain.io/api/v2" } } } }

Alternatively, create an .mcp/config.json file in your workspace root:

{ "servers": { "stampchain": { "command": "node", "args": ["./dist/index.js"], "env": { "STAMPCHAIN_API_URL": "https://stampchain.io/api/v2" } } } }
Windsurf IDE

Configure MCP in Windsurf by adding to your workspace settings:

  1. Create or edit .windsurf/mcp.json in your workspace:
{ "mcpServers": { "stampchain": { "command": "node", "args": ["${workspaceFolder}/dist/index.js"], "env": { "STAMPCHAIN_API_URL": "https://stampchain.io/api/v2", "NODE_ENV": "production" }, "capabilities": { "tools": true, "resources": false, "prompts": false } } } }
  1. Or configure globally in Windsurf settings (Settings > AI Assistant > MCP Servers).
Claude Code (VS Code Extension)

For the Claude Code extension in VS Code:

  1. Open VS Code settings (Cmd/Ctrl + ,)
  2. Search for "Claude Code MCP"
  3. Add server configuration:
{ "claudeCode.mcpServers": [ { "name": "stampchain", "command": "node", "args": ["${workspaceFolder}/dist/index.js"], "env": { "STAMPCHAIN_API_URL": "https://stampchain.io/api/v2" } } ] }

Or add to your workspace .vscode/settings.json:

{ "claudeCode.mcpServers": [ { "name": "stampchain", "command": "node", "args": ["./dist/index.js"], "env": { "STAMPCHAIN_API_URL": "https://stampchain.io/api/v2" } } ] }
Universal MCP Configuration

For IDEs that support standard MCP configuration, create an mcp.json file in your project root:

{ "version": "1.0", "servers": { "stampchain": { "command": "node", "args": ["./dist/index.js"], "env": { "STAMPCHAIN_API_URL": "https://stampchain.io/api/v2", "API_TIMEOUT": "30000" }, "capabilities": { "tools": { "enabled": true, "tools": [ "get_stamp", "search_stamps", "get_stamp_collection", "get_src20_token", "list_stamp_collections" ] } } } } }
Configuration Tips
  1. Path Resolution:
    • Use absolute paths for global installations
    • Use ${workspaceFolder} or relative paths for workspace-specific setups
    • On Windows, use forward slashes or escape backslashes
  2. Environment Variables:
    • STAMPCHAIN_API_URL: API endpoint (default: https://stampchain.io/api/v2)
    • API_TIMEOUT: Request timeout in milliseconds (default: 30000)
    • DEBUG: Enable debug logging with stampchain-mcp:*
  3. Development vs Production:
    • For development, point to dist/index.js after building
    • For production, consider using the npm-installed version
  4. Verification:
    • After configuration, restart your IDE
    • Check the MCP server status in your IDE's output/console
    • Test with a simple query like "get stamp 0"

👨‍💻 Developer Use Cases

The Stampchain MCP server enables developers to quickly integrate Bitcoin Stamps data into their applications through AI assistance. Here are common developer scenarios:

🔍 Data Integration Tasks

Ask Claude to help you:

Fetch All Stamps for Your App:

  • "Help me integrate the Stampchain API to fetch all stamps and display them in a React component"
  • "Create a Python script to retrieve stamps and save them to a PostgreSQL database"
  • "Build a Vue.js gallery component that shows the latest 50 stamps with pagination"

SRC-20 Token Integration:

  • "Generate code to display SRC-20 tokens on my website based on my Next.js codebase"
  • "Create an API endpoint that fetches token balances for a given Bitcoin address"
  • "Build a token dashboard component showing supply, holders, and recent transfers"

Collection Analytics:

  • "Help me build a collections analytics page showing volume and floor prices"
  • "Create a collection ranking system based on holder count and activity"
  • "Generate a chart component displaying collection trends over time"

🛠 Code Generation Examples

The MCP server can help generate production-ready code for:

Frontend Components:

"Create a stamp gallery component for my React app that shows: - Stamp image thumbnails - Creator information - Rarity indicators - Click to view full details Use TypeScript and Tailwind CSS to match my existing codebase"

Backend Services:

"Build a Node.js Express API that: - Caches stamp data in Redis - Provides search endpoints - Handles rate limiting - Returns paginated results Include proper error handling and TypeScript types"

Database Integration:

"Create database schemas and migration scripts for: - Storing stamp metadata - Tracking collection statistics - Indexing for fast searches Use my existing PostgreSQL setup"

📊 Analytics & Monitoring

Real-time Data Processing:

  • "Help me set up WebSocket connections to monitor new stamp creations"
  • "Create a data pipeline that processes stamp transactions and updates analytics"
  • "Build alerting for specific stamp activities or price movements"

Custom Dashboards:

  • "Generate a trading dashboard showing stamp market activity"
  • "Create admin panels for managing stamp collections"
  • "Build user portfolio pages showing owned stamps and values"

🎯 Integration Patterns

E-commerce Integration:

"I'm building an NFT marketplace. Help me: 1. Integrate stamp listings with buy/sell functionality 2. Handle Bitcoin payments and transfers 3. Create user profiles with stamp collections 4. Add stamp search and filtering capabilities"

Portfolio Tracking:

"For my crypto portfolio app, help me: 1. Track user's stamp holdings 2. Calculate portfolio values 3. Show performance metrics 4. Generate tax reports for stamp transactions"

Social Features:

"Add social features to my app: 1. User profiles showing stamp collections 2. Following/followers for collectors 3. Activity feeds for stamp trading 4. Comments and ratings on stamps"

🚀 Quick Start Queries

Once you have the MCP server configured, try these developer-focused prompts:

Getting Started:

  • "Show me how to fetch the 10 most recent stamps and explain the data structure"
  • "What's the best way to integrate stamp data into a JavaScript application?"
  • "Help me understand the SRC-20 token API endpoints and response formats"

Code Review & Optimization:

  • "Review my stamp fetching code and suggest performance improvements"
  • "Help me add error handling to my Stampchain API integration"
  • "Optimize my database queries for stamp search functionality"

Architecture Planning:

  • "Design a scalable architecture for a stamp trading platform"
  • "What's the best caching strategy for stamp metadata?"
  • "Help me plan a microservices architecture for stamp analytics"

📚 API Reference & Testing

Postman Collection: Explore the complete Stampchain API with our comprehensive Postman collection:

  • Collection Link: Stampchain OpenAPI 3.0
  • Test all endpoints interactively
  • View request/response examples
  • Copy code snippets for your preferred language
  • Understand API parameters and data structures

Using with the MCP Server:

"I want to build a stamp search feature. Show me: 1. How to use the Postman collection to test the search API 2. Generate TypeScript interfaces based on the API responses 3. Create a React component that implements the search functionality 4. Add proper error handling and loading states"

💡 Pro Tips for Developers

  1. Start with Postman: Test API endpoints in the Postman collection before coding
  2. Specify Your Tech Stack: Mention your framework, database, and tools for tailored code generation
  3. Include Context: Share relevant parts of your existing codebase for better integration
  4. Reference API Docs: Point Claude to specific Postman endpoints when asking for help
  5. Ask for Testing: Request unit tests and integration tests along with your code
  6. Request Documentation: Ask for API documentation and code comments
  7. Iterate and Refine: Build incrementally - start simple and add features

🔧 Development

Development Workflow

  1. Run in development mode:
    npm run dev
  2. Run tests:
    npm test
  3. Build for production:
    npm run build

Architecture Overview

The system follows a Model Context Protocol (MCP) server architecture with:

  • Protocol: MCP SDK for tool exposure
  • Language: TypeScript/Node.js
  • API Client: Axios for Stampchain API communication
  • Authentication: None required (public API)
  • Deployment: Local via Claude Desktop or standalone Node.js

For detailed architecture documentation, see architecture/README.md.

📚 Documentation

API Documentation

The project exposes MCP tools for Stampchain data access. For complete API documentation, see:

Stampchain API Base URLs

  • Main API: https://stampchain.io/api/v2
  • Public endpoints (no authentication required)

Testing

The project uses Jest for testing. For testing documentation, see:

Running Tests

# Run all tests npm test # Run tests in watch mode npm run test:watch # Run tests with coverage npm run test:coverage

Deployment

For deployment instructions, see:

Environment Configuration

The project requires minimal configuration:

# Stampchain API (no authentication required) STAMPCHAIN_API_URL=https://stampchain.io/api/v2 # Optional: Request timeout (milliseconds) API_TIMEOUT=30000 # Optional: Enable debug logging DEBUG=stampchain-mcp:*

🤝 Contributing

  1. Documentation: Update documentation for any changes
  2. Testing: Ensure all tests pass before submitting changes
  3. Code Quality: Follow the established linting and formatting rules
  4. MCP Standards: Follow MCP SDK best practices for tool implementation

Development Guidelines

  • Follow TypeScript best practices
  • Use the established project structure
  • Write tests for new functionality
  • Update documentation for API changes
  • Use the delegation templates for complex tasks

📞 Support and Resources

  • Stampchain API: https://stampchain.io/api/v2
  • MCP SDK Documentation: https://modelcontextprotocol.io
  • Documentation: This docs directory contains all project documentation
  • Issue Tracking: GitHub Issues
  • Bitcoin Stamps Info: https://stampchain.io

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

Project Version: 0.1.0
Last Updated: 2025-01-19
Documentation Version: 1.0

This server cannot be installed

-
security - not tested
F
license - not found
-
quality - not tested

How are these scores calculated?

A Model Context Protocol server that enables interaction with Bitcoin Stamps data via the Stampchain API, providing tools for querying stamp information, collections, and blockchain data without requiring authentication.

  1. 📋 Table of Contents
    1. 🎯 What This MCP Server Provides
      1. 🚀 Quick Start
        1. Prerequisites
        2. Installation
      2. ⚙️ IDE Configuration
        1. Claude Desktop
        2. Cursor IDE
        3. Windsurf IDE
        4. Claude Code (VS Code Extension)
        5. Universal MCP Configuration
        6. Configuration Tips
      3. 👨‍💻 Developer Use Cases
        1. 🔍 Data Integration Tasks
        2. 🛠 Code Generation Examples
        3. 📊 Analytics & Monitoring
        4. 🎯 Integration Patterns
        5. 🚀 Quick Start Queries
        6. 📚 API Reference & Testing
        7. 💡 Pro Tips for Developers
      4. 🔧 Development
        1. Development Workflow
        2. Architecture Overview
      5. 📚 Documentation
        1. API Documentation
        2. Stampchain API Base URLs
        3. Testing
        4. Running Tests
        5. Deployment
        6. Environment Configuration
      6. 🤝 Contributing
        1. Development Guidelines
      7. 📞 Support and Resources
        1. 📄 License

          Related MCP Servers

          • Bitcoin MCP Server

            AbdelStark
            A
            security
            A
            license
            A
            quality
            Facilitates interaction with the Bitcoin network via the Model Context Protocol, enabling key generation, address validation, transaction decoding, and blockchain data retrieval.
            Last updated -
            5
            103
            18
            TypeScript
            MIT License
            • Apple

          • Bybit MCP Server

            sammcj
            A
            security
            A
            license
            A
            quality
            A 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 -
            9
            14
            9
            TypeScript
            MIT License

          • MCP Blockchain Query Server

            pavel-bc
            -
            security
            F
            license
            -
            quality
            A 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
            • Linux
            • Apple

          • Binance MCP Server

            tienan92it
            -
            security
            A
            license
            -
            quality
            A Model Context Protocol server that exposes Binance cryptocurrency exchange data to LLMs, allowing agents to access real-time prices, order books, and historical market data without requiring API keys.
            Last updated -
            4
            Python
            MIT License

          View all related MCP servers

          New MCP Servers

          MCP directory API

          We provide all the information about MCP servers via our MCP API.

          curl -X GET 'https://glama.ai/api/mcp/v1/servers/stampchain-io/stampchain-mcp'

          If you have feedback or need assistance with the MCP directory API, please join our Discord server