Hackathon MCP

Consulta PerfoRank desde tu agente o app.

Genera una key temporal para trabajar con datos acotados de Argentina: ficha de una tienda, comparacion entre dos sitios, verticales, plataformas y competidores cercanos.

Main sponsors Acceso gratuito impulsado por equipos de ecommerce, datos y performance.

Endpoint

Usa el endpoint generico con tu key por header.

POST https://perforank.com/mcp Authorization: Bearer prmcp_xxxxx Content-Type: application/json

Tambien podes usar X-Perfo-Key, enviar api_key en el JSON o sumar ?key=TU_KEY a la URL para pruebas rapidas.

Datos para la IA

Para conectar un agente, modelo o cliente MCP necesita estos datos:

URL del servidor: https://perforank.com/mcp
URL recomendada con key: https://perforank.com/mcp/prmcp_xxxxx
Transporte: HTTP POST JSON.
Autenticacion recomendada: header Authorization: Bearer TU_KEY.
Autenticacion simple para hackathon: key en la URL /mcp/TU_KEY.
Listado de tools: metodo JSON-RPC tools/list.
Ejecucion: metodo JSON-RPC tools/call.

Tools

get_site: ficha resumida de una tienda.
compare_2_sites: comparacion entre dos ecommerce.
get_top_by_vertical: maximo 10 por vertical.
get_platform_snapshot: resumen acotado de una plataforma.
find_nearby_site: 3 arriba y 3 abajo por trafico.

Config generica

{
  "name": "perforank",
  "url": "https://perforank.com/mcp",
  "headers": {
    "Authorization": "Bearer prmcp_xxxxx"
  }
}

Si el cliente no deja configurar headers, usa esta variante:

{
  "name": "perforank",
  "url": "https://perforank.com/mcp/prmcp_xxxxx"
}

Alternativa tecnica si el cliente no acepta path con token: https://perforank.com/mcp?key=prmcp_xxxxx

Llamada simple

{
  "tool": "get_site",
  "arguments": {
    "url": "ejemplo.com.ar"
  }
}

JSON-RPC MCP

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "compare_2_sites",
    "arguments": {
      "url_a": "tienda-a.com.ar",
      "url_b": "tienda-b.com.ar"
    }
  }
}