Alchemy Interface Toolkit (MCP)

This plugin furnishes an interface layer utilizing the Alchemy SDK, enabling robust blockchain and non-fungible token (NFT) operations.

Core Capabilities

• Retrieve all associated NFTs for a specified wallet identifier.
• Access comprehensive metadata pertaining to any given NFT.
• Ascertain the current, highest recorded block number on the chain.
• Extensible framework allowing for the incorporation of further RPC methods as necessitated.

Deployment Instructions

Installation via Smithery Deployment Utility

For automated integration of the toolkit into your Claude Desktop environment using Smithery:

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

Manual Configuration

1. Dependency Resolution: bash npm install

2. Compilation Phase: bash npm run build

3. Credential Setup:

4. Secure an API credential from the Alchemy platform.

5. Integrate this secret into the ALCHEMY_API_KEY field within the settings.json manifest file.

6. Service Initiation: bash npm start

Exposed Operation Signatures

1. Obtain Collectibles by Proprietor

typescript POST /getNftsForOwner { "owner": "wallet_identifier" }

2. Retrieve Asset Descriptors

typescript POST /getNftMetadata { "contractAddress": "asset_contract_identifier", "tokenId": "unique_asset_serial_number" }

3. Fetch Current Chain Height

typescript POST /getBlockNumber

Fault Management

Every exposed method incorporates rigorous exception management and diagnostic output. Failures are uniformly returned adhering to the following structure:

{ "error": "Descriptive failure message" }

Operational Telemetry

The underlying server incorporates extensive internal logging via console.error to aid in debugging procedures: - Initial startup logs prefixed with [Setup]. - Activity reports tied to API request processing prefixed with [API]. - Diagnostic reports for failure handling prefixed with [Error].

Execution command example (Linux/macOS):

bash export ALCHEMY_API_KEY="KRdhdsBezoTMVajIknIxlXgBHc1Pprpw"; node dist/index.js