How to Use the Alchemy MCP in Claude Code

Q: How do I configure Claude Code to use the Alchemy server?

Run the command claude mcp add --transport http alchemy -- in your terminal. You can verify the installation by running claude mcp list.

Q: Can Claude Code extract ERC-20 balances using Alchemy?

Yes, Claude Code calls gettokenbalances to retrieve all token holdings for an address. It can then format this raw data into clean Markdown tables right in your shell.

Q: In what way does Claude Code handle block height queries with Alchemy?

The CLI client invokes getlatestblocknumber to fetch the current block height. You can use this to quickly verify if your local scripts are querying the absolute tip of the chain.

Pipe live Ethereum wallet balances and transaction receipts into Claude Code.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Alchemy MCP to Claude Code

Create your Vinkius account to connect Alchemy to Claude Code and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Alchemy with Claude Code

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Script automated wallet audits in Claude Code

The Alchemy MCP Server provides terminal-ready tools like `get_wallet_balance` to inspect on-chain assets from your command line. Claude Code calls this tool to retrieve the exact Ether balance of any address in wei. Because Claude Code runs in your shell, you can pipe this output directly into local scripts or save it to a JSON report. It simplifies command-line Ethereum verification in Claude Code without requiring heavy web3 libraries.

Validate on-chain transaction logs via CLI

Querying receipts with the `get_transaction_receipt` MCP tool retrieves the full execution data for any transaction hash you provide. Your terminal session displays event logs, gas usage, and block status immediately after execution. DevOps teams can run Claude Code in CI/CD pipelines to verify that Alchemy-tracked transactions succeeded. This setup removes the need to open a web browser to check Etherscan during Claude Code deployment runs.

Monitor node status using Claude Code terminal commands

Running the `check_api_status` tool queries the node provider to ensure the connection is active and responsive. Your CLI agent uses this tool to diagnose connection issues before executing complex on-chain scripts. If your automated cron jobs fail, running this Alchemy check in Claude Code tells you instantly if the node provider is down. This simple call acts as a lightweight health check for your Claude Code web3 workflows.

Setup guide

Set up Alchemy MCP in Claude Code

Prerequisites

Claude Code CLI installed (npm install -g @anthropic-ai/claude-code)
Active Vinkius subscription with a valid endpoint token

1

Run the add command

Open your terminal and run the command shown on the right. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com. Use --scope user to make it available across all projects.
2

Verify the connection

Start a Claude Code session and type /mcp to list connected servers. You should see alchemy-mcp with a green status indicator.
3

Start using tools

Ask Claude Code something like "Check my latest Alchemy transactions." It will automatically discover and invoke the available Alchemy tools.

Terminal

claude mcp add --transport http alchemy-mcp https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

Get your connection token →

Prerequisites

Claude Code CLI installed
Active Vinkius subscription with a valid endpoint token

1

Open the config file

Create or edit .mcp.json in your project root for project-level scope, or ~/.claude.json for user-level scope.
2

Add the Alchemy MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Restart Claude Code

Start a new Claude Code session. Type /mcp to confirm the server is connected. The tools will be automatically available in your conversation.

.mcp.json

{
  "mcpServers": {
    "alchemy-mcp": {
      "type": "url",
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Alchemy. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Alchemy now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Alchemy MCP in Claude Code

Run the command `claude mcp add --transport http alchemy -- ` in your terminal. You can verify the installation by running `claude mcp list`.

Yes, Claude Code calls `get_token_balances` to retrieve all token holdings for an address. It can then format this raw data into clean Markdown tables right in your shell.

The CLI client invokes `get_latest_block_number` to fetch the current block height. You can use this to quickly verify if your local scripts are querying the absolute tip of the chain.

Operating entirely in the terminal, Claude Code lets you run this MCP Server in GitHub Actions or Docker containers. It executes commands programmatically using secure transport protocols.

No, Claude Code processes the addresses in-memory during your terminal session. The Vinkius sandbox executes the server ephemerally, ensuring your wallet queries and transaction hashes are never recorded on disk.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript