itsanishjain / alchemy-sdk-mcp

Alchemy MCP Plugin

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:

   • Get an API key from Alchemy
   • Update the ALCHEMY_API_KEY in settings.json

4. 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