Stampchain MCP Server

# Start with default configuration npm run start # Start with custom config file npm run start -- --config config.json # Start with debug logging npm run start -- --log-level debug # Show available tools npm run tools # Show version information npm run version

- npm run dev- Start development server with hot reload
- npm run build- Build the TypeScript project
- npm run test- Run all tests
- npm run test:watch- Run tests in watch mode
- npm run test:coverage- Run tests with coverage report
- npm run typecheck- TypeScript type checking
- npm run format- Format code with Prettier
- npm run validate- Full validation suite

The project includes comprehensive test coverage:

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

src/ ├── api/ # API client and related utilities ├── config/ # Configuration management ├── interfaces/ # TypeScript interfaces ├── protocol/ # MCP protocol handlers ├── schemas/ # Zod validation schemas ├── tools/ # MCP tool implementations ├── utils/ # Utility functions ├── index.ts # Main entry point └── server.ts # Server implementation

All tools accept various parameters for filtering and pagination:

- limit- Number of results to return (default: 10, max: 100)
- page- Page number for pagination (default: 1)
- sort- Sort field and direction (e.g., "created_desc")

- success- Boolean indicating if the request was successful
- data- The requested data (stamps, collections, tokens)
- pagination- Pagination information when applicable
- error- Error details if the request failed
- Build Errors: Ensure you have Node.js 18+ and runnpm installfirst
- Connection Issues: Check that the Stampchain API is accessible
- MCP Client Integration: Verify the path in your configuration file is correct

Enable debug logging to see detailed information:

Or set the log level in your configuration:

{ "logging": { "level": "debug" } }

This project maintains comprehensive test coverage across multiple areas:

- ✅Unit Tests- Core utilities and helper functions
- ✅Integration Tests- MCP server functionality
- ✅API Validation- Ensures v2.3 API compatibility
- ✅Schema Validation- TypeScript and Zod schema alignment
- ✅Cross-platform- Tested on Ubuntu, Windows, and macOS
- ✅Multi-version- Node.js 18.x, 20.x, and 22.x support
- ✅Real API Testing- Validates against live Stampchain API v2.3

# Run specific test suites npm run test:unit # Unit tests for utilities and helpers npm run test:integration # Integration tests for MCP server npm run test:api # API validation tests (v2.3 compatibility) npm run test:tools # Tool functionality tests npm run test:schemas # Schema validation tests # Advanced testing options npm run test:ui # Run tests in UI mode (interactive) npm run test:ci # CI test run (includes coverage) npm run validate # Full validation (schema + typecheck + format + tests)

- Install dependencies:npm install
- Start development server:npm run dev
- Run tests in watch mode:npm run test:watch
- Validate before commit:npm run validate
- Fork the repository
- Create a feature branch:git checkout -b feature/new-feature
- Make your changes
- Run tests:npm test
- Commit your changes:git commit -am 'Add new feature'
- Push to the branch:git push origin feature/new-feature
- Submit a pull request

- Use TypeScript for all new code
- Follow TypeScript strict mode guidelines
- Write tests for new features
- Update documentation as needed
- Runnpm run validatebefore submitting PRs

- Stampchain API v2.3 Compatibility: Updated schemas and validation for latest API
- Enhanced Testing: Comprehensive test suite with cross-platform CI validation
- Improved Documentation: Professional README with status badges and better organization
- Simplified Development: Streamlined validation pipeline (TypeScript + Prettier)
- Bug Fixes: Resolved CI issues and schema validation improvements

- Initial release
- Basic Bitcoin Stamps, Collections, and SRC-20 tools
- MCP client integration
- Comprehensive test suite

Official Airtable MCP server and skills for working with bases, records, workflows, and business operations from AI agents.

MCP Server For Apache Doris, an MPP-based real-time data warehouse.

Official MCP Server from Atlan which enables you to bring the power of metadata to your AI tools

Query Onchain data, like ERC20 tokens, transaction history, smart contract state.

Read and write access to your Baserow tables.

Introspect and query your apps deployed to Convex.

Interact with the data stored in Couchbase clusters using natural language.