alchemy-mcp

Alchemy MCP

ホスト型 Alchemy MCP サーバーを使用すると、AI クライアント内からライブのブロックチェーンデータ、トランザクションのシミュレーション、トレース、NFT／ポートフォリオの照会、Alchemy アプリの管理を行えます。

このスキルを使用する場合

次のすべてに当てはまる場合は、alchemy-mcp を使用してください。

• ユーザーがライブでエージェントを実行する作業（このセッション中にエージェントが実行するライブ照会、分析、管理作業、またはマシン上での自動化）を求めている
• MCP 対応クライアント（Claude Code、Codex、Cursor、Claude Desktop、VS Code Copilot など）がすでに https://mcp.alchemy.com/mcp に接続されているか、ユーザーが接続する意思がある
• Alchemy CLI（@alchemy/cli）がローカルにインストールされていない

CLI がローカルにインストールされている場合、または CLI と MCP の両方を利用できる場合は、代わりに alchemy-cli スキルを優先してください。CLI は、優先的に使用するローカルのフォールバック実行環境です。

別のスキルを使用する場合

状況	代わりに使用するスキル
@alchemy/cli がローカルにインストールされている、または CLI と MCP の両方を利用できる	alchemy-cli
CLI も MCP も利用できない	alchemy-cli（npm i -g @alchemy/cli）をインストールしてから、alchemy-cli を使用する
Alchemy API キーを使って、このエージェントのセッション外で実行するアプリケーションコードを構築する	alchemy-api
API キーなしでアプリケーションコードを構築する場合、自力で利用料金を賄う必要がある自律型エージェントを構築する場合、または x402/MPP を明示的に使用したい場合	agentic-gateway

このスキルを本番用アプリケーションコードの作成に使用しないでください。MCP ツールはライブでのエージェント作業向けであり、リリースするソフトウェアへの組み込みには使用しません。

クライアントを接続する

サーバーは https://mcp.alchemy.com/mcp で稼働しており、OAuth による認証を使用します。初回利用時、クライアントでブラウザーが開き、Alchemy アカウントでサインインします。API キーもローカルへのインストールも不要です。

Claude Code

最も手早く接続するには、この MCP サーバー、スラッシュコマンド（/alchemy:balance、/alchemy:nfts、/alchemy:portfolio など）、Alchemy エージェントスキルをまとめてインストールできる公式の Alchemy Claude Plugin を使用します。

/plugin marketplace add alchemyplatform/alchemy-claude-plugin
/plugin install alchemy@alchemy

次に /alchemy:setup を実行して、このセッションで使用するアプリを選択します。最初に Alchemy ツールを呼び出すと、OAuth が自動的に開きます。

プラグインを使わずに MCP サーバーだけを接続するには、次の手動コマンドを使用します。

claude mcp add alchemy --transport http https://mcp.alchemy.com/mcp

Claude Code を再起動し、/mcp を実行して alchemy を選択し、認証します。

Codex

codex mcp add alchemy --url https://mcp.alchemy.com/mcp

codex mcp list を実行して確認します。

Cursor

~/.cursor/mcp.json（グローバル）または .cursor/mcp.json（プロジェクト）に追加します。

{
  "mcpServers": {
    "alchemy": {
      "type": "streamable-http",
      "url": "https://mcp.alchemy.com/mcp"
    }
  }
}

Cursor を再起動し、Cursor Settings > MCP で確認します。

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json（macOS）または %APPDATA%\Claude\claude_desktop_config.json（Windows）に追加します。

{
  "mcpServers": {
    "alchemy": {
      "type": "streamable-http",
      "url": "https://mcp.alchemy.com/mcp"
    }
  }
}

VS Code Copilot

プロジェクト内の .vscode/mcp.json に追加します。

{
  "servers": {
    "alchemy": {
      "type": "http",
      "url": "https://mcp.alchemy.com/mcp"
    }
  }
}

その他の MCP クライアント

Streamable HTTP トランスポートを使って、https://mcp.alchemy.com/mcp に接続します。サーバーは PKCE を使った OAuth 2.1 に対応しており、クライアントが認可フローを自動的に処理します。

初期設定のワークフロー

サーバーへの接続が完了し、OAuth でサインインしたら、次の手順に従います。

1. アプリを一覧表示する — list_apps を実行して、Alchemy アプリを確認します。
2. アプリを選択する — アプリ ID を指定して select_app を実行します。これにより、サーバーが RPC ツールと Data ツールで使用する API キーがキャッシュされます。RPC ツールまたは Data ツールを呼び出す前に必ず実行してください。
3. ツールを実行する — 159 個のツールから任意のものを呼び出します（例：getTokenPricesBySymbol、getNFTsForOwner、simulateAssetChanges、solana_getBalance）。

先にアプリを作成する必要がある場合は、次の手順に従います。

create_app(name="My App", networks=["eth-mainnet", "base-mainnet"])

次に、新しいアプリを指定して select_app を実行します。

ツールカタログ

サーバーは、3 つのカテゴリにわたる159 個のツールを公開しています。

Admin（8 個のツール） — アカウントとアプリの管理

ツール	目的
ping	ヘルスチェック
list_apps	Alchemy アプリの一覧を取得
get_app	アプリの詳細を取得
select_app	アプリを選択し、RPC／データツール用の API キーをキャッシュ
create_app	新しいアプリを作成
update_app	アプリ名または説明を更新
list_chains	サポートされている 100 以上のネットワークをすべて一覧表示
update_allowlist	アプリの許可リスト（ネットワーク、アドレス、オリジン、IP）を更新

RPC（123 個のツール） — オンチェーン JSON-RPC

標準 EVM RPC、Token API、Transfers & Receipts、Transaction Simulation、Trace API、Debug API、ERC-4337 Account Abstraction、Solana 標準 RPC、Solana Enhanced & DAS。

クラスター	数	例
標準 EVM RPC	31	ethBlockNumber、ethGetBalance、ethCall、ethGetLogs、ethCallBundle
Token API	3	getTokenBalances、getTokenMetadata、getTokenAllowance
Transfers & Receipts	2	getAssetTransfers、getTransactionReceipts
Transaction Simulation	5	simulateAssetChanges、simulateExecution、simulateUserOperationAssetChanges
Trace API	6	traceCall、traceTransaction、traceBlock、traceFilter
Debug API	6	debugTraceTransaction、debugTraceCall、debugTraceBlockByNumber
ERC-4337 Account Abstraction	7	estimateUserOperationGas、getUserOperationReceipt、requestGasAndPaymasterAndData
Solana 標準 RPC	50	solana_getBalance、solana_getTokenAccountsByOwner、solana_getBlock、solana_simulateTransaction
Solana Enhanced & DAS	13	solana_getAsset、solana_getAssetsByOwner、solana_searchAssets、solana_getPriorityFeeEstimate

Data（28 個のツール） — REST API

クラスター	数	例
NFT API	21	getNFTsForOwner、getNFTMetadata、getOwnersForNFT、getFloorPrice、getNFTsForContract
Prices API	3	getTokenPricesBySymbol、getTokenPricesByAddress、getHistoricalTokenPrices
Portfolio（マルチチェーン）	4	getTokensByAddress、getTokenBalancesByAddress、getNFTsByAddress、getNFTContractsByAddress

よくあるタスク → ツール対応表

タスク	ツール	備考
最新の ETH ブロック番号	ethBlockNumber	network: "eth-mainnet" を渡します
アドレスの ETH 残高	ethGetBalance	16 進数の wei を返します
ERC-20 残高	getTokenBalances	シンボルと小数桁数を取得するには getTokenMetadata を使用します
ERC-20 メタデータ	getTokenMetadata	名前、シンボル、小数桁数、ロゴ
アセットの送金（履歴）	getAssetTransfers	category（erc20、erc721、erc1155、external、internal）でフィルタリングします
トランザクションのシミュレーション	simulateAssetChanges	事前にアセットの変化を確認
トランザクションのトレース	traceTransaction	内部呼び出しツリー
トランザクションのデバッグトレース	debugTraceTransaction	Geth 形式の構造化トレース
所有 NFT の一覧	getNFTsForOwner	1 つのチェーンを対象
マルチチェーン NFT	getNFTsByAddress	複数のチェーンを対象
NFT メタデータ	getNFTMetadata	トークン ID ごと
NFT フロア価格	getFloorPrice	主要マーケットプレイスから取得
トークン価格（スポット）	getTokenPricesBySymbol	例：["ETH","USDC"]
トークン価格（過去）	getHistoricalTokenPrices	期間を指定したクエリ
マルチチェーンポートフォリオ	getTokenBalancesByAddress	USD 価値付き
Solana の残高	solana_getBalance	Lamports
Solana のトークンアカウント	solana_getTokenAccountsByOwner	SPL トークン
圧縮 NFT の検索	solana_getAsset	DAS 標準
所有者の圧縮 NFT	solana_getAssetsByOwner	DAS 標準
Solana の優先手数料	solana_getPriorityFeeEstimate	直近のサンプル
ユーザー操作のレシート	getUserOperationReceipt	ERC-4337

運用ルール

• RPC ツールまたはデータツールを使う前に、必ず最初に select_app を呼び出してください。アプリが選択されていない場合、ツールは明確なメッセージを表示してエラーになります。
• list_chains が返す正規のチェーンスラッグを使用してください（例：eth-mainnet、base-mainnet、solana-mainnet）。間違った値を指定した場合は、ツールのエラーメッセージが正しい値を案内します。
• エージェント内から raw curl／HTTP を使って MCP サーバーを迂回しないでください。これは API キーを使う経路であり、alchemy-api が対象としています。このスキルでは MCP ツールが正式なインターフェースです。
• MCP ツールを本番アプリケーションコードの生成に使わないでください。ユーザーが出荷可能なコードを求めている場合は、alchemy-api（API キーあり）または agentic-gateway（API キーなし）に引き継いでください。

対応チェーン

Ethereum、Base、Polygon、Arbitrum、Optimism、BNB、Solana、Starknet、zkSync、Scroll、Linea、Mantle、Blast、World Chain など、100 を超えるチェーンに対応しています。list_chains を使って全リストを取得してください。

トラブルシューティング

「No app selected」

希望するアプリ ID を指定して select_app を呼び出してください。まだアプリがない場合は、まず create_app を実行してください。

OAuth フローが開かない

サーバーを追加した後、MCP クライアントを再起動してください。Claude Code の場合は、/mcp を実行して alchemy を選択すると、手動でサインインフローを開始できます。

ツールが見つからない

一部のツールは名前空間が付いています（例：Solana 用の solana_*）。list_chains でチェーンスラッグを確認し、上記のツールカタログで正確な名前を確認してください。

レート制限／計算ユニット

MCP サーバーには、選択したアプリのレート制限が適用されます。Alchemy ダッシュボードで使用状況を確認してください。

公式リンク

• Alchemy MCP サーバー（ホスト型）
• Alchemy MCP の GitHub ソース
• Alchemy 開発者向けドキュメント
• Model Context Protocol
• Alchemy ダッシュボード