Provides documentation and schemas for querying Ethereum blockchain data, including EVM RPC, Beacon Chain, and Firehose data sources, with support for handling blockchain reorganizations and real-time data patterns
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Amp MCPhow do I handle blockchain reorgs in my queries?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Amp MCP
A Model Context Protocol (MCP) server providing developer-focused documentation for Amp - a high-performance ETL system for blockchain data. This server helps developers building applications on Amp by providing access to essential documentation, schemas, troubleshooting guides, and code examples.
What is Amp?
Amp is a high-performance ETL system that:
Extracts data from various blockchain sources (EVM RPC, Firehose, Beacon Chain)
Transforms it via SQL queries with custom User-Defined Functions (UDFs)
Loads it into Parquet files for efficient querying
Serves it through multiple query interfaces (Arrow Flight gRPC, JSON Lines HTTP)
This MCP server focuses on documentation that helps developers build applications using Amp, answer questions about Amp, and troubleshoot issues.
Installation
Or with pnpm:
Usage
As an MCP Server
Add to your MCP client configuration (e.g., Claude Desktop):
Or if installed locally:
Available Resources
The server provides developer-focused documentation for building applications on Amp:
Core Documentation
amp-docs://amp- Main documentation indexamp-docs://amp-getting-started- Getting started guide (START HERE!)amp-docs://amp-config- Configuration guide for developersamp-docs://amp-glossary- Definitions of key terms
Developer Guides
amp-docs://amp-examples- Complete example applications with codeamp-docs://amp-querying-data- How to query blockchain dataamp-docs://amp-troubleshooting- Common issues and solutions
Data Sources & Schemas
amp-docs://amp-udfs- User-Defined Functions for SQL queriesamp-docs://amp-schemas-evm-rpc- EVM RPC schema documentationamp-docs://amp-schemas-firehose-evm- Firehose EVM schemaamp-docs://amp-schemas-eth-beacon- Ethereum Beacon Chain schemaamp-docs://amp-manifest-schemas- Dataset definition schemas
Blockchain-Specific
amp-docs://amp-reorgs- Handling blockchain reorganizations
Admin API Error Documentation
amp-docs://admin-api-errors- Comprehensive error code reference (JSON format)
Operational Documentation
Documentation from the amp repository for deployment, installation, and operations:
amp-repo-docs://amp-repo- Main installation guide (ampup, Nix, building from source)amp-repo-docs://amp-repo-references-concepts- Technical overview and core conceptsamp-repo-docs://amp-repo-references-operational-mode- Operational modes explainedamp-repo-docs://amp-repo-how-to-single-node- Single-node development modeamp-repo-docs://amp-repo-how-to-serverless-mode- Serverless deploymentamp-repo-docs://amp-repo-how-to-battleship- Battleship deployment patternamp-repo-docs://amp-repo-quick-start-local- Local development quick startamp-repo-docs://amp-repo-quick-start-ampup- Quick start with ampup installer
Available Tools
amp-documentation
Fetches and concatenates documentation for specified sections.
amp-all-documentation
Fetches all Amp documentation at once.
amp-doc-links
Returns resource links for specified sections.
admin-api-error-lookup
Lookup detailed information about a specific Admin API error code.
Returns detailed documentation including:
HTTP status code
Endpoint where error occurs
Description of the error
Conditions that trigger this error
Example error response
admin-api-errors-by-endpoint
Get all possible error codes for a specific Admin API endpoint.
Returns a formatted list of all errors that can occur on the specified endpoint.
admin-api-all-errors
Get a complete reference of all Admin API error codes.
No parameters required. Returns a comprehensive table of all error codes with their HTTP status codes and endpoints.
amp-repo-documentation
Fetches operational documentation from the amp repository.
Returns documentation for deployment, installation, and operational guides.
amp-repo-all-documentation
Fetches all operational documentation from the amp repository at once.
No parameters required. Returns all guides including quick starts, how-tos, and reference documentation.
Development
Building
Running Locally
Development Mode (with watch)
Documentation Coverage
This MCP server includes developer-focused documentation for building applications on Amp:
Getting Started
Complete getting started guide with installation options
Example applications (Vite+React, Next.js, Fastify backend)
Querying data guide with JSON Lines and Arrow Flight patterns
Developer Guides
Working with data sources (EVM RPC, Firehose, Beacon Chain)
Using SQL queries and User-Defined Functions
Building frontends with TanStack Query or Effect Atom
Building backends with Arrow Flight
Real-time data patterns and polling
Configuration & Schema Reference
Configuring Amp for your application
Dataset versioning system
Schema documentation for all data sources
Dataset definition schemas
Troubleshooting
Common issues and solutions when building on Amp
Understanding blockchain reorganizations and how to handle them
License
MIT