MercadoLibre MCP Server

Instructions

Implementation Reference

• src/handlers/tools.handler.ts:84-93 (handler)

  Handler case in callTool method that processes seller_reputation tool call by extracting sellerId and delegating to apiService.sellerReputation, then returning JSON-formatted response.

  case 'seller_reputation': {
    const { sellerId } = args as { sellerId: string }
    const reputation = await this.apiService.sellerReputation(sellerId)
    return {
      content: [{
        type: 'text',
        text: JSON.stringify(reputation, null, 2)
      }]
    }
  }

• src/handlers/tools.handler.ts:41-49 (schema)

  Input schema definition for the seller_reputation tool, specifying sellerId as required string.

  inputSchema: {
    type: 'object',
    properties: {
      sellerId: {
        type: 'string',
        description: 'ID del vendedor'
      }
    }
  }

• src/handlers/tools.handler.ts:38-50 (registration)

  Tool registration in listTools method, including name, description, and input schema.

  {
    name: 'seller_reputation',
    description: 'Obtiene la reputación de un vendedor',
    inputSchema: {
      type: 'object',
      properties: {
        sellerId: {
          type: 'string',
          description: 'ID del vendedor'
        }
      }
    }
  },

• src/services/api.service.ts:50-58 (helper)

  Core implementation in ApiService that fetches the seller's reputation data from MercadoLibre API endpoint /users/{sellerId}.

  async sellerReputation (sellerId: string) {
    const headers = await this.getHeaders()
    const response = await fetch(`${this.baseURL}users/${sellerId}`, { headers })
    if (!response.ok) {
      throw new Error(`HTTP error! status: ${response.status}`)
    }
    const data = await response.json()
    return data
  }