mercadolibre-mcp

Instructions

Implementation Reference

• src/actions.ts:56-61 (handler)

  The main handler function that executes the get_seller_info tool logic. It takes a MercadoLibreClient and GetSellerInfoParams, then makes an API call to the /users/{seller_id} endpoint.

  export async function getSellerInfo(
    client: MercadoLibreClient,
    params: GetSellerInfoParams
  ): Promise<unknown> {
    return client.get(`/users/${encodeURIComponent(String(params.seller_id))}`);
  }

• src/schemas.ts:27-29 (schema)

  Type definition for the get_seller_info tool input parameters, defining that seller_id is a required number.

  export interface GetSellerInfoParams {
    seller_id: number;
  }

• src/mcp-server.ts:104-119 (registration)

  MCP server tool registration for get_seller_info with Zod schema validation and error handling. Registers the tool with description, input schema (seller_id as number), and async handler that calls tools.get_seller_info.

  server.tool(
    "get_seller_info",
    "Get seller profile including reputation, ratings, and transaction stats.",
    {
      seller_id: z.number().describe("Seller user ID"),
    },
    async (params) => {
      try {
        const result = await tools.get_seller_info(params);
        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
      } catch (error) {
        const message = error instanceof Error ? error.message : String(error);
        return { content: [{ type: "text", text: message }], isError: true };
      }
    },
  );

• src/index.ts:33-33 (registration)

  Tool registration in the createMercadoLibreTools factory function, mapping the get_seller_info tool name to the getSellerInfo handler function.

  get_seller_info: (params: GetSellerInfoParams) => getSellerInfo(client, params),