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
npm install @edgeandnode/amp-mcp
Or with pnpm:
pnpm add @edgeandnode/amp-mcp
Usage
As an MCP Server
Add to your MCP client configuration (e.g., Claude Desktop):
{
"mcpServers": {
"amp": {
"command": "npx",
"args": ["-y", "@edgeandnode/amp-mcp"]
}
}
}
Or if installed locally:
{
"mcpServers": {
"amp": {
"command": "node",
"args": ["/path/to/amp-mcp/dist/index.js"]
}
}
}
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.
{
sections: ["amp", "amp/config", "amp/udfs"]
}
amp-all-documentation
Fetches all Amp documentation at once.
amp-doc-links
Returns resource links for specified sections.
{
sections: ["amp/config", "amp/udfs"]
}
admin-api-error-lookup
Lookup detailed information about a specific Admin API error code.
{
errorCode: "DATASET_NOT_FOUND"
}
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.
{
endpoint: "/datasets"
}
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.
{
docIds: [
"amp-repo",
"amp-repo/references/concepts",
"amp-repo/quick-start/local"
]
}
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
pnpm install
pnpm build
Running Locally
pnpm start
Development Mode (with watch)
pnpm dev
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