Alchemy SDK

by itsanishjain

Not rated
GitHub

About

Integrates with the Alchemy SDK to enable blockchain and NFT operations, including retrieving metadata, fetching token balances, and querying blockchain data.

Details

Author
itsanishjain
Repository
itsanishjain/alchemy-sdk-mcp
Categories
AI, Design, Developer Tools, Search, Infrastructure, Frontend
Tags
#integration

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

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Alchemy SDK
    Command (node, npx, python, etc.) node
    Arguments
    • Argument 1 dist/index.js
    Environment
    • ALCHEMY_API_KEY KRdhdsBezoTMVajIknIxlXgBHc1Pprpw

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

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

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

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

getNftsForOwner

Retrieve NFTs owned by a specific wallet address. Parameters: owner (string - the wallet address)

getNftMetadata

Fetch metadata for a specific NFT. Parameters: contractAddress (string - the contract address), tokenId (string - the token ID)

getBlockNumber

Get the latest block number from the blockchain.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "alchemy sdk": {
            "env": {
                "ALCHEMY_API_KEY": "KRdhdsBezoTMVajIknIxlXgBHc1Pprpw"
            },
            "args": [
                "dist/index.js"
            ],
            "command": "node"
        }
    }
}

Linux

{
    "env": {
        "ALCHEMY_API_KEY": "KRdhdsBezoTMVajIknIxlXgBHc1Pprpw"
    },
    "args": [
        "dist/index.js"
    ],
    "command": "node"
}

Macos

{
    "env": {
        "ALCHEMY_API_KEY": "KRdhdsBezoTMVajIknIxlXgBHc1Pprpw"
    },
    "args": [
        "dist/index.js"
    ],
    "command": "node"
}

Windows

{
    "env": {
        "ALCHEMY_API_KEY": "KRdhdsBezoTMVajIknIxlXgBHc1Pprpw"
    },
    "args": [
        "/c",
        "node",
        "dist/index.js"
    ],
    "command": "cmd"
}

Alchemy MCP Plugin

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:
- 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

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.