Alchemy MCP

Utilisez le serveur Alchemy MCP hébergé pour accéder à des données blockchain en direct, simuler des transactions, tracer des appels, interroger des NFT/portefeuilles et administrer les apps Alchemy depuis votre client IA.

Quand utiliser cette compétence (scope_in)

Utilisez alchemy-mcp quand toutes les conditions suivantes sont vraies :

• L'utilisateur veut du travail agent en direct — des requêtes en direct, de l'analyse, du travail d'administration ou de l'automatisation que l'agent exécute maintenant dans cette session
• Un client compatible MCP (Claude Code, Codex, Cursor, Claude Desktop, VS Code Copilot, etc.) est déjà connecté à https://mcp.alchemy.com/mcp, OU l'utilisateur est disposé à l'ajouter
• La CLI Alchemy (@alchemy/cli) n'est pas installée localement

Si la CLI est installée localement — ou si la CLI et MCP sont tous les deux disponibles — préférez la compétence alchemy-cli à la place. La CLI est le chemin d'exécution local préféré.

Quand NE PAS utiliser cette compétence (scope_out, transfert)

Ne pas utiliser cette compétence pour écrire du code applicatif en production — les outils MCP sont pour le travail agent en direct, pas pour l'intégration dans des logiciels déployés.

Connecter votre client

Le serveur s'exécute à https://mcp.alchemy.com/mcp et s'authentifie via OAuth — votre client ouvre un navigateur pour se connecter avec votre compte Alchemy à la première utilisation. Aucune clé API ni installation locale requise.

Claude Code

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

Redémarrez Claude Code, puis exécutez /mcp et sélectionnez alchemy pour vous authentifier.

Codex

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

Vérifiez avec codex mcp list.

Cursor

Ajoutez à ~/.cursor/mcp.json (global) ou .cursor/mcp.json (projet) :

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

Redémarrez Cursor et vérifiez via Cursor Settings > MCP.

Claude Desktop

Ajoutez à ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) ou %APPDATA%\Claude\claude_desktop_config.json (Windows) :

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

VS Code Copilot

Ajoutez à .vscode/mcp.json dans votre projet :

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

Tout autre client MCP

Pointez-le vers https://mcp.alchemy.com/mcp en utilisant le transport Streamable HTTP. Le serveur prend en charge OAuth 2.1 avec PKCE ; le client gère automatiquement le flux d'autorisation.

Flux de démarrage

Une fois le serveur connecté et que vous êtes connecté via OAuth :

1. Lister les apps — list_apps pour voir vos apps Alchemy.
2. Sélectionner une app — select_app avec l'ID de l'app. Cela met en cache la clé API que le serveur utilise pour les outils RPC et Data. Obligatoire avant tout appel à un outil RPC ou Data.
3. Exécuter les outils — appelez l'un des 159 outils (p. ex. getTokenPricesBySymbol, getNFTsForOwner, simulateAssetChanges, solana_getBalance).

Si vous devez créer une app en premier :

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

Puis select_app avec la nouvelle app.

Catalogue des outils

Le serveur expose 159 outils répartis en trois catégories.

Admin (8 outils) — Gestion des comptes et apps

RPC (123 outils) — JSON-RPC on-chain

JSON-RPC EVM standard, Token API, Transfers & Receipts, Transaction Simulation, Trace API, Debug API, ERC-4337 Account Abstraction, Solana standard RPC, et Solana Enhanced & DAS.

Data (28 outils) — REST APIs

Correspondance courante tâche → outil

Règles d'exploitation

• Toujours appeler select_app en premier avant tout outil RPC ou Data. Les outils affichent un message d'erreur clair si aucune app n'est sélectionnée.
• Utiliser les slugs de chaîne canoniques retournés par list_chains (p. ex. eth-mainnet, base-mainnet, solana-mainnet). Les messages d'erreur des outils vous guideront si vous devinez mal.
• Ne pas contourner le serveur MCP avec des requêtes curl/HTTP brutes depuis l'agent — c'est le chemin de la clé API couvert par alchemy-api. Les outils MCP sont l'interface canonique pour cette compétence.
• Ne pas utiliser les outils MCP pour générer du code applicatif en production. Quand l'utilisateur veut déployer du code, transférez à alchemy-api (avec clé API) ou alchemy-agentic-gateway (sans).

Chaînes supportées

100+ chaînes incluant Ethereum, Base, Polygon, Arbitrum, Optimism, BNB, Solana, Starknet, zkSync, Scroll, Linea, Mantle, Blast, World Chain, et bien d'autres. Utilisez list_chains pour récupérer la liste complète.

Dépannage

"No app selected"

Appelez select_app avec l'ID de l'app souhaitée. Si vous n'avez pas encore d'app, exécutez d'abord create_app.

Le flux OAuth ne s'ouvre pas

Redémarrez votre client MCP après avoir ajouté le serveur. Pour Claude Code, exécutez /mcp et sélectionnez alchemy pour déclencher manuellement le flux de connexion.

Outil non trouvé

Certains outils sont en espace de noms (p. ex. solana_* pour Solana). Utilisez list_chains pour confirmer le slug de chaîne et vérifiez le catalogue des outils ci-dessus pour le nom exact.

Limites de débit / unités de calcul

Le serveur MCP hérite les limites de débit de l'app sélectionnée. Vérifiez l'utilisation dans le tableau de bord Alchemy.

Liens officiels

• Serveur Alchemy MCP (hébergé)
• Source Alchemy MCP sur GitHub
• Docs développeur Alchemy
• Model Context Protocol
• Tableau de bord Alchemy