multichain_transactions

Fetch paginated transaction history for multiple EVM addresses across multiple blockchain networks in a single API call. Analyze cross-chain activity and build activity feeds with optional logs and value conversion.

Instructions

Fetch paginated transactions for up to 10 EVM addresses and 10 EVM chains with one API call. Useful for building Activity Feeds. Requires addresses array. Optional parameters include chains array, pagination (before/after), limit (default 10), quoteCurrency for value conversion, and options to include logs (withLogs, withDecodedLogs). Use this to analyze transaction history across different networks simultaneously.

Input Schema

TableJSON Schema

Name	Required	Description
`chains`	No	Array of blockchain networks to query. Can be chain names (e.g., 'eth-mainnet') or chain IDs (e.g., 1). If not specified, queries all supported chains.
`addresses`	No	Array of wallet addresses to get transactions for. Each address should be a valid blockchain address.
`limit`	No	Maximum number of transactions to return per request. Default is 10, maximum is 100.
`before`	No	Pagination cursor to get transactions before this point. Use the 'before' value from previous response.
`after`	No	Pagination cursor to get transactions after this point. Use the 'after' value from previous response.
`withLogs`	No	Include transaction logs in the response. Default is false.
`withDecodedLogs`	No	Include decoded transaction logs in the response. Only applicable when withLogs is true. Default is false.
`quoteCurrency`	No	Currency to quote token values in (e.g., 'USD', 'EUR'). If not specified, uses default quote currency.

Implementation Reference

src/services/AllChainsService.ts:95-124 (handler)

The handler for the multichain_transactions tool, which executes the GoldRush client call to getMultiChainMultiAddressTransactions.

async (params) => {
    try {
        const response =
            await goldRushClient.AllChainsService.getMultiChainMultiAddressTransactions(
                {
                    chains: params.chains as Chain[],
                    addresses: params.addresses,
                    limit: params.limit,
                    before: params.before,
                    after: params.after,
                    withLogs: params.withLogs,
                    withDecodedLogs: params.withDecodedLogs,
                    quoteCurrency: params.quoteCurrency as Quote,
                }
            );
        return {
            content: [
                {
                    type: "text",
                    text: stringifyWithBigInt(response.data),
                },
            ],
        };
    } catch (error) {
        return {
            content: [{ type: "text", text: `Error: ${error}` }],
            isError: true,
        };
    }
}

src/services/AllChainsService.ts:35-94 (schema)

Input schema validation for the multichain_transactions tool using Zod.

{
    chains: z
        .array(
            z.union([
                z.enum(
                    Object.values(ChainName) as [string, ...string[]]
                ),
                z.number(),
            ])
        )
        .optional()
        .describe(
            "Array of blockchain networks to query. Can be chain names (e.g., 'eth-mainnet') or chain IDs (e.g., 1). If not specified, queries all supported chains."
        ),
    addresses: z
        .array(z.string())
        .optional()
        .describe(
            "Array of wallet addresses to get transactions for. Each address should be a valid blockchain address."
        ),
    limit: z
        .number()
        .optional()
        .default(10)
        .describe(
            "Maximum number of transactions to return per request. Default is 10, maximum is 100."
        ),
    before: z
        .string()
        .optional()
        .describe(
            "Pagination cursor to get transactions before this point. Use the 'before' value from previous response."
        ),
    after: z
        .string()
        .optional()
        .describe(
            "Pagination cursor to get transactions after this point. Use the 'after' value from previous response."
        ),
    withLogs: z
        .boolean()
        .optional()
        .default(false)
        .describe(
            "Include transaction logs in the response. Default is false."
        ),
    withDecodedLogs: z
        .boolean()
        .optional()
        .default(false)
        .describe(
            "Include decoded transaction logs in the response. Only applicable when withLogs is true. Default is false."
        ),
    quoteCurrency: z
        .enum(Object.values(validQuoteValues) as [string, ...string[]])
        .optional()
        .describe(
            "Currency to quote token values in (e.g., 'USD', 'EUR'). If not specified, uses default quote currency."
        ),
},

src/services/AllChainsService.ts:28-94 (registration)

Registration of the multichain_transactions tool within the MCP server.

server.tool(
    "multichain_transactions",
    "Fetch paginated transactions for up to 10 EVM addresses and 10 EVM chains with one API call. Useful for building Activity Feeds. " +
        "Requires addresses array. Optional parameters include chains array, " +
        "pagination (before/after), limit (default 10), quoteCurrency for value conversion, " +
        "and options to include logs (withLogs, withDecodedLogs). " +
        "Use this to analyze transaction history across different networks simultaneously.",
    {
        chains: z
            .array(
                z.union([
                    z.enum(
                        Object.values(ChainName) as [string, ...string[]]
                    ),
                    z.number(),
                ])
            )
            .optional()
            .describe(
                "Array of blockchain networks to query. Can be chain names (e.g., 'eth-mainnet') or chain IDs (e.g., 1). If not specified, queries all supported chains."
            ),
        addresses: z
            .array(z.string())
            .optional()
            .describe(
                "Array of wallet addresses to get transactions for. Each address should be a valid blockchain address."
            ),
        limit: z
            .number()
            .optional()
            .default(10)
            .describe(
                "Maximum number of transactions to return per request. Default is 10, maximum is 100."
            ),
        before: z
            .string()
            .optional()
            .describe(
                "Pagination cursor to get transactions before this point. Use the 'before' value from previous response."
            ),
        after: z
            .string()
            .optional()
            .describe(
                "Pagination cursor to get transactions after this point. Use the 'after' value from previous response."
            ),
        withLogs: z
            .boolean()
            .optional()
            .default(false)
            .describe(
                "Include transaction logs in the response. Default is false."
            ),
        withDecodedLogs: z
            .boolean()
            .optional()
            .default(false)
            .describe(
                "Include decoded transaction logs in the response. Only applicable when withLogs is true. Default is false."
            ),
        quoteCurrency: z
            .enum(Object.values(validQuoteValues) as [string, ...string[]])
            .optional()
            .describe(
                "Currency to quote token values in (e.g., 'USD', 'EUR'). If not specified, uses default quote currency."
            ),
    },

GoldRush MCP Server