Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Connect AI agents to Alchemy

Scalekit connector
Open markdown

The Alchemy connector lets your AI agent act in each user's Alchemy account. Each user connects their own Alchemy API key once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 60 tools.

Tools
60
What they doRead · write · destructive
56 · 4 · 056 read4 write0 destructive
Users sign in with

Setup

  1. Install the SDK

    Terminal window
    npm install @scalekit-sdk/node dotenv
  2. Set your credentials

    Add your Scalekit credentials to your .env file. Find values in app.scalekit.com > Developers > API Credentials.

    .env
    SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
    SCALEKIT_CLIENT_ID=<your-client-id>
    SCALEKIT_CLIENT_SECRET=<your-client-secret>
  3. Create the Alchemy connection

    In AgentKit > Connections, create an Alchemy connection. The name you give it is the connection_name your code passes. See Configure connections.

  4. Authorize a user and make your first call

    quickstart.mts
    import { ScalekitClient } from '@scalekit-sdk/node'
    import 'dotenv/config'
    import { createInterface } from 'node:readline/promises'
    const scalekit = new ScalekitClient(
    process.env.SCALEKIT_ENVIRONMENT_URL,
    process.env.SCALEKIT_CLIENT_ID,
    process.env.SCALEKIT_CLIENT_SECRET,
    )
    const actions = scalekit.actions
    const connector = 'alchemy'
    const identifier = 'user_123'
    // Generate an authorization link for the user
    const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
    console.log('Authorize Alchemy:', link)
    const rl = createInterface({ input: process.stdin, output: process.stdout })
    await rl.question('Press Enter after authorizing...')
    rl.close()
    // Make your first call
    const result = await actions.executeTool({
    connector,
    identifier,
    toolName: 'alchemy_block_number_get',
    toolInput: {},
    })
    console.log(result)
    Terminal window
    npx tsx quickstart.mts

    Each user opens the link once and enters their Alchemy credentials there. See Authorize a user for the full flow and statuses.

Tools

Pass the exact name to execute_tool
Try in PlaygroundRequest a tool
  • alchemy_access_list_createBuild an EIP-2930 access list for a transaction (eth_createAccessList).Read-only

    Create Access List

    Build an EIP-2930 access list for a transaction (eth_createAccessList). Returns the access list and the gas used with it. Use Estimate Gas for a plain gas estimate.

    Inputs

    tostringrequired
    Address the call is sent to. Example: 0xA0b86991c6218b36c1d19d4a2e9eB0cE3606eB48.
    blockstring
    Block number in hex (for example 0x10d4f), or a tag: latest (default), safe, finalized, earliest or pending. Example: latest.
    datastring
    Hex-encoded call data: method signature hash and encoded arguments. Example: 0x70a08231000000000000000000000000d8da6bf26964af9d7eed9e03e53415d37aa96045.
    fromstring
    Address the call is sent from. Example: 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045.
    gasstring
    Gas limit, as hex. Example: 0x5208.
    gas_pricestring
    Gas price in wei, as hex. Rarely needed. Example: 0x9184e72a000.
    valuestring
    Value to send, in wei, as hex. Example: 0x0.
  • alchemy_airdrop_nft_checkCheck whether an NFT was airdropped (minted to the holder by another sender).Read-only

    Is Airdrop NFT

    Check whether an NFT was airdropped (minted to the holder by another sender). Returns isAirdrop true or false. Use Get NFTs for Owner with exclude_filters AIRDROPS to hide airdrops.

    Inputs

    contract_addressstringrequired
    Contract address of the NFT collection (ERC-721 or ERC-1155). Example: 0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D.
    token_idstringrequired
    Token ID, in decimal or hex. Example: 44.
  • alchemy_asset_transfers_getGet the history of native, internal and token transfers to or from an address (alchemy_getAssetTransfers).Read-only

    Get Asset Transfers

    Get the history of native, internal and token transfers to or from an address (alchemy_getAssetTransfers). Returns transfers with block, hash, from, to, value, asset and category, plus pageKey. Use Get Wallet Transaction History for full transactions across networks.

    Inputs

    categoryarrayrequired
    Transfer types: external, internal, erc20, erc721, erc1155, specialnft. internal is only on Ethereum and Polygon mainnet. Example: ["external", "erc20"].
    contract_addressesarray
    Only token transfers from these contracts (erc20, erc721, erc1155). Example: ["0xA0b86991c6218b36c1d19d4a2e9eB0cE3606eB48"].
    exclude_zero_valueboolean
    Skip zero-value transfers. Defaults to true. Example: true.
    from_addressstring
    Only transfers sent from this address. Example: 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045.
    from_blockstring
    First block, hex or latest. Defaults to 0x0. Example: 0x0.
    max_countstring
    Maximum results per page, as hex, up to 0x3e8 (1000). Example: 0x64.
    orderstring
    asc (default) or desc by block. Example: desc.one of ascdesc
    page_keystring
    Pagination key from the previous call. Example: 8f1c2d3e-4b5a-6978-8a9b-0c1d2e3f4a5b.
    to_addressstring
    Only transfers sent to this address. Example: 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045.
    to_blockstring
    Last block, hex or latest. Defaults to latest. Example: latest.
    with_metadataboolean
    Include block timestamps. Example: true.
  • alchemy_balance_getGet an address's native coin balance (for example ETH) at a block (eth_getBalance).Read-only

    Get Balance

    Get an address's native coin balance (for example ETH) at a block (eth_getBalance). Returns the balance in wei as hex. Use Get Token Balances for ERC-20 tokens.

    Inputs

    addressstringrequired
    Account or contract address (20 bytes, hex). Example: 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045.
    blockstring
    Block number in hex (for example 0x10d4f), or a tag: latest (default), safe, finalized, earliest or pending. Example: latest.
  • alchemy_block_by_hash_getGet a block by its hash (eth_getBlockByHash).Read-only

    Get Block by Hash

    Get a block by its hash (eth_getBlockByHash). Returns the block header and its transaction hashes, or full transactions. Use Get Block by Number for a block number or tag.

    Inputs

    block_hashstringrequired
    Block hash (32 bytes, hex). Example: 0xb3b20624f8f0f86eb50dd04688409e5cea4bd02d700bf6e79e9384d47d6a5a35.
    full_transactionsboolean
    true returns full transaction objects; false (default) returns only hashes. Example: false.
  • alchemy_block_by_number_getGet a block by number or tag (eth_getBlockByNumber).Read-only

    Get Block by Number

    Get a block by number or tag (eth_getBlockByNumber). Returns the block header and its transaction hashes, or full transactions. Use Get Block by Hash when you have the hash.

    Inputs

    blockstringrequired
    Block number in hex, or a tag: latest, safe, finalized, earliest or pending. Example: latest.
    full_transactionsboolean
    true returns full transaction objects; false (default) returns only hashes. Example: false.
  • alchemy_block_by_timestamp_getFind the first block before or after a timestamp on one or more networks.Read-only

    Get Block by Timestamp

    Find the first block before or after a timestamp on one or more networks. Returns each network's block number and on-chain timestamp. Use it to turn dates into block ranges for Get Logs or Get Asset Transfers.

    Inputs

    directionstringrequired
    Return the first block "BEFORE" or "AFTER" the provided timestamp. Example: BEFORE.one of BEFOREAFTER
    networksarrayrequired
    Network IDs to query, for example eth-mainnet or base-mainnet. Example: ["eth-mainnet"].
    timestampstringrequired
    Unix or ISO timestamp. Example: 2026-11-01T00:00:00Z.
  • alchemy_block_number_getGet the latest block number on the connection's network (eth_blockNumber).Read-only

    Get Block Number

    Get the latest block number on the connection's network (eth_blockNumber). Returns the block number as a hex string. Use Get Block by Number for the block's contents.

    Inputs

    This tool takes no inputs.