Alchemy
Alchemy is a blockchain development platform that provides powerful APIs and developer tools for building and scaling Ethereum applications
Verdict
Common use cases
- Audit NFT ownership before a community airdrop
- Track token balances for portfolio reporting
- Pull sales history for pricing analysis
- Verify contract metadata for due diligence
- Monitor transaction counts for fraud detection
Integration
- Vendor
- Alchemy
- Category
- developer-tools
- Auth
- API_KEY
- Tools
- 7
- Composio slug
alchemy
Tools
- Get NFT Contract Metadata
This tool retrieves metadata for a given nft smart contract. essential for obtaining basic nft collection details such as contract name, symbol, total supply, token type (erc721 vs erc1155), contract deployer address, deployed block number,
- Get NFT Owners
This tool retrieves the owner(s) for a specific nft token, supporting both erc721 and erc1155 tokens on ethereum and several layer 2 chains such as polygon, arbitrum, optimism, and base. it requires the contract address and tokenid, and ret
- Get NFT Sales
This tool will retrieve nft sales data across various marketplaces. it allows users to query historical nft sales data with filtering options such as fromblock, toblock, order, marketplace, and limit in order to track nft sales activity, an
- Get NFTs for Contract
This tool retrieves all nfts for a given contract address. it is designed to return a complete list of nfts from a specific nft collection by accepting parameters such as contractaddress (required), withmetadata (optional), pagesize (option
- Get Token Balances
This tool retrieves erc20 token balances for a specified ethereum address. it can either return balances for all tokens an address has ever interacted with or for a specific set of token contract addresses. it is useful for checking token b
- Get Token Metadata
This tool retrieves metadata for a given token contract address, including the token's name, symbol, decimals, and logo url if available. it is essential for applications that need to display token information, handle token transfers, or ma
- Get Transaction Count
This tool retrieves the number of transactions sent from a specific address (also known as the nonce). it uses the eth gettransactioncount endpoint to return the transaction count for an address at a specified block tag (latest, pending, ea
Setup
Setup guide
- 11. Open your Switchy workspace and navigate to Settings > Integrations > Developer Tools. 2. Click 'Connect' next to Alchemy and paste your API key from the Alchemy dashboard (sign up at alchemy.com if you don't have one). 3. Select the networks you want to query — Ethereum mainnet, Polygon, Arbitrum, Optimism, or Base. 4. Click 'Save' and wait for the green checkmark confirming the connection is active. 5. Open any Space and type '@Alchemy get token balances for 0x...' (replace with a real address) to test the connection. 6. If the tool returns balance data, you're ready to invoke any of the seven available tools by @mentioning Alchemy and describing what you need. 7. Check your Alchemy dashboard to monitor API usage and ensure you stay within your plan's rate limits.
What teammates see: by default, memories from Alchemy are scoped to the Space (PROJECT visibility) - you can mark any memory PRIVATE or share it ORG-wide.
Works well with
Top models
Compatibility data appears once enough Spaces have used this MCP together with a given model.
How Switchy teams use it
Starter prompts
Check Wallet Holdings
@Alchemy get token balances for address 0x1234567890abcdef1234567890abcdef12345678 and format the results as a table with token name, symbol, and balance.Open in a Space →
Retrieve NFT Collection Info
@Alchemy get NFT contract metadata for 0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d and summarize the collection's key details in two sentences.Open in a Space →
Find NFT Owners
@Alchemy get NFT owners for contract 0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d token ID 1 and list all current owners with their addresses.Open in a Space →
Analyze Recent Sales
@Alchemy get NFT sales for contract 0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d from the last 100 blocks and show the top 5 sales by price.Open in a Space →
Count Address Transactions
@Alchemy get transaction count for address 0x1234567890abcdef1234567890abcdef12345678 and tell me if this address has been active in the last month.Open in a Space →
Example outputs
Illustrative - representative of the model's voice and quality, not literal recordings.
@alchemy what's the current token balance for address 0x742d35Cc6634C0532925a3b844Bc454e4438f44e across all ERC-20 tokens it holds?
Based on the Get Token Balances query, this address currently holds balances in 4 ERC-20 tokens: 1,250.43 USDC, 0.87 WETH, 500 DAI, and 12.5 UNI. The tool returns token contract addresses, raw balances (in smallest unit), and decimal-adjusted amounts. This example illustrates a typical wallet inspection workflow where you'd see all fungible token holdings at once, useful for portfolio tracking or wallet analysis.
This example uses the Get Token Balances tool, which requires an Alchemy API key with mainnet access. The response reflects on-chain state at query time — balances change with every transaction. If you need historical balances, you'd specify a block number. Rate limits apply based on your Alchemy tier (free tier: 330 compute units/second).
@alchemy fetch the complete metadata for the Bored Ape Yacht Club NFT contract at 0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D including token type and total supply
The Get NFT Contract Metadata tool returns: Contract Name: 'BoredApeYachtClub', Symbol: 'BAYC', Token Type: 'ERC721', Total Supply: 10,000, Deployed Block: 12287507. This example shows how to retrieve foundational collection details without querying individual token IDs — essential for building NFT marketplace UIs or validating contract authenticity before deeper queries.
This read-only query showcases the Get NFT Contract Metadata tool. It works across Ethereum mainnet and major L2s (Polygon, Arbitrum, Optimism, Base). The metadata returned is static contract-level data, not individual token attributes. For token-specific traits (image, rarity), you'd follow up with Get NFTs for Contract. No write permissions needed.
@alchemy pull the last 50 NFT sales from OpenSea for contract 0x60E4d786628Fea6478F785A6d7e704777c86a7c6 (MAYC) and summarize the floor price trend over the past week
The Get NFT Sales tool retrieves 50 recent transactions, each with sale price (in ETH), buyer/seller addresses, marketplace, and block timestamp. Analyzing the dataset: the floor price started at 11.2 ETH seven days ago, peaked at 13.5 ETH mid-week, and settled at 12.1 ETH in the last 24 hours — a 8% net increase. This example pairs Alchemy's sales data with AI reasoning to surface market trends without manual spreadsheet work.
This synthesis example combines Get NFT Sales (which supports filtering by marketplace, block range, and sort order) with the AI's analytical capabilities. The tool returns raw transaction data; the AI interprets trends. Be aware: sales data lags by ~1 block confirmation time, and the 'limit' parameter caps results (max varies by tier). Historical queries beyond 30 days may require archive node access.
Use-case deep-dives
When Alchemy wins for customer support at NFT projects
A 3-person support team at a 10k-collection NFT project fields 40+ tickets a day asking 'where's my mint' or 'why can't I see my token'. The Get NFT Owners and Get NFTs for Contract tools let the team verify ownership and metadata in seconds without switching to Etherscan or waiting on engineering. This MCP is the right call if your contract is on Ethereum, Polygon, Arbitrum, Optimism, or Base and your team already has an Alchemy API key. If you're multi-chain beyond those five or need real-time floor-price data, you'll hit the edge of what these seven tools cover. For pure ownership and metadata lookups at small-team scale, Alchemy keeps support moving without custom scripts.
When this MCP handles treasury reporting at crypto startups
A 2-person finance team at a DeFi protocol runs monthly treasury reports that track ERC20 balances across 8 operational wallets. The Get Token Balances and Get Token Metadata tools pull current holdings and display-ready token info in one call, replacing a patchwork of manual Etherscan exports and spreadsheet lookups. This MCP is the right call if your wallets are Ethereum-native and you need programmatic access without building your own indexer. If you're tracking balances on non-EVM chains or need historical snapshots at arbitrary block heights, the 7-tool scope here won't cover it. For Ethereum treasury work at startup scale, Alchemy turns a 2-hour monthly chore into a 10-minute Switchy query.
When Alchemy fits NFT sales research at small studios
A 4-person product team at an NFT gaming studio reviews competitor sales trends every sprint to inform drop timing and pricing strategy. The Get NFT Sales tool surfaces historical marketplace data with filters for block range and marketplace, letting the team compare volume spikes without hiring a data analyst or subscribing to Dune. This MCP is the right call if you're researching Ethereum-based collections and your questions fit within the tool's marketplace coverage. If you need cross-chain sales or real-time streaming data, the 7-tool set won't scale. For periodic competitive research at small-studio cadence, Alchemy gives product teams the sales context they need without a dedicated data stack.
Frequently asked
What does the Alchemy MCP let me do in Switchy?
It gives your AI agents read access to blockchain data — NFT metadata, token balances, transaction counts, and sales history across Ethereum and L2s like Polygon and Arbitrum. You can query contract details, find NFT owners, or pull ERC20 balances without writing Web3 code. It's for teams building crypto tools or analyzing on-chain activity inside Switchy workflows.
Do I need an Alchemy account to connect this MCP?
Yes. You need an Alchemy API key, which means signing up at alchemy.com and creating a project. The free tier covers most exploratory work; you'll hit rate limits if you're querying thousands of contracts daily. Paste the API key into Switchy's connection form and you're live — no OAuth dance, no admin approval.
Can the Alchemy MCP write to the blockchain or send transactions?
No. It's read-only. You can query NFT owners, token balances, and sales data, but you can't mint tokens, transfer assets, or execute smart-contract functions. If you need to write on-chain, you'll have to use Alchemy's SDK or a wallet integration outside Switchy.
Why use this instead of calling Alchemy's API directly?
The MCP wraps Alchemy's endpoints so your AI agents can call them in natural language — no JSON payloads, no rate-limit logic, no parsing hex strings. If you're already piping Alchemy responses into GPT prompts, this saves the middleware. If you need sub-100ms latency or custom caching, stick with the raw API.
Who on my team should connect the Alchemy MCP?
Whoever owns your Alchemy account or has the API key. Once connected in Switchy, any team member can invoke the tools in shared chats — they don't need their own Alchemy login. If you're on a paid Alchemy plan, watch your request quotas; heavy agent usage counts the same as direct API calls.