Adamik MCP Server

Instructions

Implementation Reference

• src/module.ts:413-428 (handler)

  The handler function that fetches transaction details from the Adamik API using makeApiRequest and returns a text content response with JSON-stringified data.

  async ({ chainId, transactionId }: GetTransactionDetailsPathParams) => {
    const transaction = await makeApiRequest<GetTransactionDetailsResponse>(
      `${ADAMIK_API_BASE_URL}/${chainId}/transaction/${transactionId}`,
      ADAMIK_API_KEY
    );
  
    const text = JSON.stringify(transaction);
    return {
      content: [
        {
          type: "text",
          text,
        },
      ],
    };
  }

• src/schemas.ts:240-250 (schema)

  Zod schemas and TypeScript types for the input path parameters (chainId, transactionId) and response (transaction details and status) of the getTransactionDetails tool.

  export const GetTransactionDetailsPathParamsSchema = z.object({
    chainId: ChainIdSchema,
    transactionId: z.string(),
  });
  export type GetTransactionDetailsPathParams = z.infer<typeof GetTransactionDetailsPathParamsSchema>;
  
  export const GetTransactionDetailsResponseSchema = z.object({
    transaction: TransactionDetailSchema,
    status: TransactionStatusSchema,
  });
  export type GetTransactionDetailsResponse = z.infer<typeof GetTransactionDetailsResponseSchema>;

• src/module.ts:406-429 (registration)

  Registration of the getTransactionDetails tool using server.tool(), including name, description, input schema validation, and handler function.

  server.tool(
    "getTransactionDetails",
    "Gets info about a transaction",
    {
      chainId: ChainIdSchema,
      transactionId: z.string(),
    },
    async ({ chainId, transactionId }: GetTransactionDetailsPathParams) => {
      const transaction = await makeApiRequest<GetTransactionDetailsResponse>(
        `${ADAMIK_API_BASE_URL}/${chainId}/transaction/${transactionId}`,
        ADAMIK_API_KEY
      );
  
      const text = JSON.stringify(transaction);
      return {
        content: [
          {
            type: "text",
            text,
          },
        ],
      };
    }
  );