CSPR[dot]trade MCP

Instructions

Implementation Reference

• packages/mcp/src/tools/account.ts:41-49 (handler)

  MCP tool handler for 'get_swap_history' that calls the SDK client.

  async (args) => {
    const result = await client.getSwapHistory({
      publicKey: args.public_key,
      pairContractPackageHash: args.pair,
      page: args.page,
      pageSize: args.page_size,
    });
    return { content: [{ type: 'text' as const, text: JSON.stringify(result, null, 2) }] };
  },

• packages/mcp/src/tools/account.ts:32-50 (registration)

  Registration of the 'get_swap_history' MCP tool.

  server.tool(
    'get_swap_history',
    'Get swap transaction history',
    {
      public_key: z.string().optional().describe('Filter by sender public key (hex)'),
      pair: z.string().optional().describe('Filter by pair contract package hash'),
      page: z.number().optional(),
      page_size: z.number().optional(),
    },
    async (args) => {
      const result = await client.getSwapHistory({
        publicKey: args.public_key,
        pairContractPackageHash: args.pair,
        page: args.page,
        pageSize: args.page_size,
      });
      return { content: [{ type: 'text' as const, text: JSON.stringify(result, null, 2) }] };
    },
  );

• packages/sdk/src/client.ts:169-177 (handler)

  SDK client implementation of getSwapHistory.

  async getSwapHistory(opts?: SwapHistoryQuery) {
    const accountHash = opts?.publicKey
      ? PublicKey.fromHex(opts.publicKey).accountHash().toHex()
      : undefined;
    return this.swapsApi.getSwaps({
      senderAccountHash: accountHash,
      pairContractPackageHash: opts?.pairContractPackageHash,
      page: opts?.page,
      pageSize: opts?.pageSize,