axie-mcp

Instructions

Implementation Reference

• src/index.ts:698-730 (handler)

  The handler function for the 'search_lands' tool, which parses input arguments, constructs GraphQL variables, and queries the client.

  case "search_lands": {
    const schema = z.object({
      owner: RoninAddress.optional(),
      landType: LandTypeEnum.optional(),
      from: z.coerce.number().int().min(0).default(0),
      size: z.coerce.number().int().min(1).max(100).default(10),
      sort: SortByEnum.optional(),
      auctionType: AuctionTypeEnum.optional(),
    });
    const parsed = schema.parse(args ?? {});
  
    const variables: Record<string, unknown> = {
      from: parsed.from,
      size: parsed.size,
    };
    if (parsed.auctionType) variables.auctionType = parsed.auctionType;
    if (parsed.sort) variables.sort = parsed.sort;
    if (parsed.owner) {
      variables.owner = {
        address: parsed.owner,
        ownerships: ["Owned"],
      };
    }
    if (parsed.landType) {
      variables.criteria = { landType: [parsed.landType] };
    }
  
    const data = await client.query<{ lands: unknown }>(
      queries.GET_LANDS,
      variables
    );
    return jsonContent(data.lands);
  }

• src/index.ts:303-320 (registration)

  Tool definition/registration for 'search_lands'.

  name: "search_lands",
  description:
    "Search for land plots on the Axie Infinity marketplace with optional filters.",
  inputSchema: {
    type: "object",
    properties: {
      owner: {
        type: "string",
        description: "Filter by owner Ronin address (ronin:xxxx or 0x...).",
      },
      landType: {
        type: "string",
        enum: ["Savannah", "Forest", "Arctic", "Mystic", "Genesis", "LunaLanding"],
        description: "Filter by land type.",
      },
      from: {
        type: "number",
        description: "Pagination offset. Default 0.",