Alchemy Data Access Service (MCP Implementation)

This Model Context Protocol (MCP) infrastructure establishes a structured conduit for autonomous agents to interface directly with the comprehensive backend services provided by Alchemy for blockchain data querying. It abstracts the underlying API complexity, allowing agents to request ledger statistics natively.

Principal Utility

This server module functions as an intermediary layer, permitting AI constructs to conduct the following operations against Alchemy's network endpoints:

• Inquire about asset denominations and their historical pricing trajectories (supporting temporal range specification).
• Ascertain ownership status of unique digital assets (NFTs) and retrieve associated contract metadata.
• Audit the sequence of financial movements associated with specified addresses across heterogeneous chains.
• Inspect the current quantity of fungible assets held across multiple blockchain environments.
• Obtain granular records of asset movements, including sophisticated filtering parameters.
• Initiate ledger commitment operations via programmable smart accounts (prerequisite: functional wallet agent backend).
• Orchestrate asset exchanges through decentralized finance (DeFi) mechanisms (prerequisite: functional wallet agent backend).
• And supplementary functions.

Rapid Deployment Configuration

To rapidly deploy this MCP service, integrate the subsequent configuration stanza into your designated MCP configuration file (commonly residing in client application settings):

{
  "mcpServers": {
    "alchemy": {
      "command": "npx",
      "args": [
        "-y",
        "@alchemy/mcp-server"
      ],
      "env": {
        "ALCHEMY_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

This configuration facilitates server instantiation without manual repository cloning.

Runtime Configuration Parameters

The service mandates the declaration of the following environmental parameter:

• ALCHEMY_API_KEY - The requisite authentication credential for accessing all blockchain data streams.

For functions involving transaction submission or atomic exchange, the following must additionally be configured:

• AGENT_WALLET_SERVER - The network locator (URL) pointing to an operational wallet agent server responsible for secure smart account maneuvers.

⚠️ Critical Notice: The capabilities exposed by sendTransaction and swap remain inert unless a correctly provisioned wallet agent backend is referenced. These functions depend on external cryptographic infrastructure for transaction signing and network propagation.

Exposed Functionality Catalog

Agents may invoke the following methods to access data:

Asset Valuation Interfaces

1. fetchTokenPriceBySymbol
2. Retrieves instantaneous valuation metrics based on asset ticker symbol.

3. Illustrative Query: "Ascertain the present valuation metrics for ETH and BTC tickers."

4. fetchTokenPriceByAddress

5. Retrieves instantaneous valuation metrics based on asset contract identifier.

6. Illustrative Query: "What is the market value of the asset identified by address 0x1234...5678 on the primary Ethereum ledger?"

7. fetchTokenPriceHistoryBySymbol

8. Obtains historical valuation data constrained by specific temporal windows.

9. Illustrative Query: "Chart the price progression for BTC from January 1st through February 1st, 2023, utilizing daily periodicity."

10. fetchTokenPriceHistoryByTimeFrame

11. Retrieves historical valuation data employing elastic time constraints or natural language descriptions.
12. Illustrative Query: "Display the valuation trend for ETH over the preceding seven days," or "Acquire BTC valuation data spanning the last thirty days."

Cross-Chain Asset Inventory

1. fetchTokensOwnedByMultichainAddresses
2. Queries fungible asset holdings for specified identifiers across multiple heterogeneous ledgers.
3. Illustrative Query: "Detail the fungible assets held by address 0xabc...123 across the Ethereum and Base environments."

Transactional Provenance Access

1. fetchAddressTransactionHistory
2. Retrieves the chronological record of ledger interactions for addresses across various chains.

3. Illustrative Query: "Present the recent transactional activity for identifier 0xdef...456 on the Ethereum network."

4. fetchTransfers

5. Retrieves comprehensive asset movement records augmented with complex filtering capabilities.
6. Illustrative Query: "List all ERC-20 asset transfers directed to or originating from 0xghi...789."

Digital Collectible (NFT) Interfaces

1. fetchNftsOwnedByMultichainAddresses
2. Retrieves all unique digital assets held by identifiers, incorporating defense against spam assets.

3. Illustrative Query: "Enumerate the NFTs possessed by entity 0xjkl...012."

4. fetchNftContractDataByMultichainAddress

5. Fetches descriptive metadata for NFT contracts associated with given addresses.
6. Illustrative Query: "Which NFT series collections are represented by assets belonging to 0xmno...345?"

Transaction Execution Interfaces

1. sendTransaction
   • Dispatches atomic ledger operations utilizing Smart Contract Accounts.
   • ⚠️ Essential Prerequisite: Mandates an instantiated wallet agent backend configured via AGENT_WALLET_SERVER.
   • Illustrative Query: "Transmit 0.1 ETH to recipient address 0xpqr...678."

Asset Exchange Interfaces

1. swap
   • Executes algorithmic asset exchanges via established Decentralized Exchange (DEX) protocols (e.g., Uniswap).
   • ⚠️ Essential Prerequisite: Mandates an instantiated wallet agent backend configured via AGENT_WALLET_SERVER.
   • Illustrative Query: "Convert 100 units of USDC into ETH."

Local Development and Open Source Engagement

Setup Procedures

1. Clone the source repository structure

git clone https://github.com/alchemyplatform/alchemy-mcp.git
cd alchemy-mcp

1. Install requisite dependencies

pnpm install

Iterative Development Mode

pnpm watch

Production Artifact Generation

pnpm build

Debugging Aid: Utilizing the MCP Inspector

The MCP Inspector tool furnishes a graphical environment for validating server interactions:

pnpm inspector

This command initiates the Inspector interface accessible via a web browser. It permits users to: - Review the complete inventory of accessible operational endpoints. - Stress-test endpoints using varied input parameters. - Scrutinize the resulting data payload. - Diagnose faults within the server deployment.

Collaborative Contributions

We welcome external code submissions (Pull Requests). For substantive modifications, kindly initiate a discussion by filing an issue beforehand to align on the proposed changes.

Licensing Stipulations

This MCP service is distributed under the permissive MIT License. This license grants freedom to utilize, adapt, and disseminate the software, subject only to adhering to the terms and conditions outlined within the MIT License document.

Representative Agent Instructions

Below are sample operational instructions that an intelligent agent can employ with this service:

What is the present valuation for both Bitcoin and Ethereum?

Examine the non-fungible assets owned by wallet 0x1234...5678 on the Ethereum ledger.

List the fungible assets held by wallet 0xabcd...6789 across Ethereum and Base.

Retrieve the complete transactional record for identifier 0x9876...5432.

Map the price trajectory of Ethereum from the commencement of January 1st until the present epoch, using daily intervals.

Obtain Bitcoin valuation data covering the last week, sampled hourly.

Display the performance metrics for ETH across the previous lunar cycle.

Detail all ERC-20 transfer events associated with address 0x1234...5678 occurring within the last 100 block confirmations.

Underlying System Documentation Linkage

For exhaustive technical specifications regarding Alchemy's core interfaces, consult: - Alchemy API Documentation