$ timeahead.in
/servers/blog/about
/ servers/npm/@alchemy/mcp-server
npm

@alchemy/mcp-server

MCP server for using Alchemy APIs

★ 86 stars↓ 9k/wkupdated 57d agogithub ↗
☆ Watch this server📋 Install guide⚡ Compare⚑ Claim listing
74fair
▣ Overview

What it does

This MCP server enables AI agents to query Alchemy's blockchain APIs without writing code, exposing 97 structured tools. It provides token price lookups (current and historical with flexible time-frame queries), NFT ownership and contract data retrieval, multi-network balance checking, and detailed transaction analysis. Two deployment modes are available: a hosted remote server at mcp.alchemy.com (recommended) authenticating via OAuth, or a local STDIO mode that runs on-premises with an API key. Optional wallet agent integration unlocks transaction signing and DEX swaps through Smart Contract Accounts.

Who it's for

Backend engineers building AI-powered dapps, blockchain developers integrating Claude into contract workflows, and teams deploying agents that analyze or interact with on-chain data without requiring Web3 expertise.

Common use cases

  • Query current and historical token prices across flexible time frames
  • Check token and NFT balances across Ethereum, Base, and other networks
  • Retrieve NFT collections and contract metadata for addresses
  • Analyze transaction history and asset transfer patterns
  • Sign and broadcast transactions via Smart Contract Accounts

Setup pitfalls

  • Secrets in codebase: Registry scanner detected 2 secrets; audit before self-hosting locally.
  • Authentication differs by mode: Hosted server uses OAuth (no key needed); local STDIO requires ALCHEMY_API_KEY environment variable.
  • Wallet server dependency: sendTransaction and swap tools require AGENT_WALLET_SERVER URL configured; they will not function without it.
  • Rate limits and uptime dependencies: All queries depend on Alchemy API availability and rate limits.
⚠ 2 credentials detected in repository history via Gitleaks
▣ Score BreakdownMCPScore = Σ(raw × weight)
DimensionRawWeighted
Security
35%
60
21.0
Freshness
25%
100
25.0
Adoption
20%
67
13.4
Quality
10%
100
10.0
Trust
10%
50
5.0
Total
74.4
⚿ Capabilities & Risk Explainer
fs writenetworksecrets
◆ Risk level: medium· 97 tools · auth: API key
fs write + network + secrets — requires access to credentials or environment secrets.
Tool nameDescriptionDestructive?
listSupportedNetworks✓ no
fetchTokenPriceBySymbol✓ no
fetchTokenPriceByAddress✓ no
fetchTokenPriceHistoryBySymbol✓ no
fetchTokenPriceHistoryByTimeFrame✓ no
+45 more tools
fetchTokensOwnedByMultichainAddresses✓ no
fetchAddressTransactionHistory✓ no
fetchTransfers✓ no
fetchNftsOwnedByMultichainAddresses✓ no
fetchNftContractDataByMultichainAddress✓ no
sendTransaction✓ no
swap✓ no
getNFTsForOwner✓ no
getNFTsForContract✓ no
getNFTsForCollection✓ no
getNFTMetadata✓ no
getContractMetadata✓ no
getCollectionMetadata✓ no
invalidateNFTContractCache✓ no
getOwnersForNFT✓ no
getOwnersForContract✓ no
getSpamContracts✓ no
isSpamContract✓ no
isAirdropNFT⚠⚠ yes
summarizeNFTAttributes✓ no
getFloorPrice✓ no
searchContractMetadata✓ no
isHolderOfContract✓ no
computeRarity✓ no
getNFTSales✓ no
getContractsForOwner✓ no
getCollectionsForOwner✓ no
reportSpam✓ no
getTokenAllowance✓ no
getTokenBalances✓ no
getTokenMetadata✓ no
getTransactionReceipts✓ no
debugGetRawBlock✓ no
debugGetRawHeader✓ no
debugGetRawReceipts✓ no
debugTraceBlockByHash✓ no
debugTraceBlockByNumber✓ no
debugTraceCall✓ no
debugTraceTransaction✓ no
traceBlock✓ no
traceCall✓ no
traceGet✓ no
traceRawTransaction✓ no
traceReplayBlockTransactions✓ no
traceReplayTransaction✓ no
⚙ Install config
Claude Desktop · Cursor · Windsurf · VS Code (Copilot) · Claude Code
add to your MCP client config:
{
  "mcpServers": {
    "alchemymcp": {
      "command": "npx",
      "args": [
        "-y",
        "@alchemy/mcp-server"
      ]
    }
  }
}
📈 Score historylast 35 snapshots
4/30/20266/13/2026 · 35 snapshots
⚙ Maintenance health
59/ 100 · is this project alive?
contributors (1y)5
top contributor share57%
releases (1y)3
last release78d ago
ci✓ passing
⛁ Raw data
weekly downloads9k
github stars86
forks32
open issues9
license✓ present
readme length8191 chars
last publish3d ago
last commit57d ago
last updated1d ago
install verified✓ pass · 22d ago
owner of this server? claim your listing to get a verified badgeclaim →
🔔 Score drop alerts
get notified by email when this server's score drops 5+ points