mercadolibre-mcp

Instructions

Implementation Reference

• src/actions.ts:34-39 (handler)

  The getItemDescription function that implements the actual tool logic. It makes an API call to the MercadoLibre API endpoint '/items/{item_id}/description' using the provided client.

  export async function getItemDescription(
    client: MercadoLibreClient,
    params: GetItemDescriptionParams
  ): Promise<unknown> {
    return client.get(`/items/${encodeURIComponent(params.item_id)}/description`);
  }

• src/schemas.ts:15-17 (schema)

  The GetItemDescriptionParams interface defining the input schema for the tool, which requires an item_id string parameter.

  export interface GetItemDescriptionParams {
    item_id: string;
  }

• src/mcp-server.ts:53-68 (registration)

  The MCP server tool registration for 'get_item_description'. Defines the tool name, description, Zod schema for validation, and the async handler that calls the tools.get_item_description method.

  server.tool(
    "get_item_description",
    "Get the full text description of a MercadoLibre item.",
    {
      item_id: z.string().describe("Item ID"),
    },
    async (params) => {
      try {
        const result = await tools.get_item_description(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:30-30 (registration)

  The tool creation in createMercadoLibreTools function that creates the get_item_description tool binding, passing the client and parameters to getItemDescription.

  get_item_description: (params: GetItemDescriptionParams) => getItemDescription(client, params),