alchemy sdk mcp

Local 2025-09-01 00:37:04 0
Finance @itsanishjain/alchemy-sdk-mcp

This plugin enables interaction with blockchain data and NFTs through the Alchemy SDK, allowing operations such as retrieving NFT metadata, fetching NFTs for wallet addresses, and getting the latest block number.

smithery badge

This MCP plugin provides integration with the Alchemy SDK for blockchain and NFT operations.

Features

  • Get NFTs for a wallet address
  • Get NFT metadata
  • Get latest block number
  • More endpoints can be added as needed

Setup

Installing via Smithery

To install alchemy-sdk-mcp for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @itsanishjain/alchemy-sdk-mcp --client claude

Manual Installation

  1. Install dependencies: 

    npm install

  2. Build the project: 

    npm run build

  3. Configure your Alchemy API key:

  4. Get an API key from Alchemy

  5. Update the ALCHEMY_API_KEY in settings.json

  6. Start the server: 

    npm start

Available Endpoints

1. Get NFTs for Owner

POST /getNftsForOwner
{
    "owner": "wallet_address"
}

2. Get NFT Metadata

POST /getNftMetadata
{
    "contractAddress": "contract_address",
    "tokenId": "token_id"
}

3. Get Block Number

POST /getBlockNumber

Error Handling

All endpoints include proper error handling and logging. Errors are returned in the format: 

{
    "error": "Error message"
}

Logging

The server implements comprehensive logging using console.error for better debugging: - [Setup] logs for initialization - [API] logs for API calls - [Error] logs for error handling

$env:ALCHEMY_API_KEY="KRdhdsBezoTMVajIknIxlXgBHc1Pprpw"; node dist/index.js