Servidor MCP

El Model Context Protocol es la forma en que un asistente de IA alcanza herramientas fuera de sí mismo. El servidor MCP de Namesight es un pequeño programa que lo habla: el asistente pide una comprobación de nombre, el servidor llama a la misma API pública que llamarías tú y devuelve el resultado.

No guarda ningún dato propio. Los ámbitos, los créditos y los límites de peticiones los aplica la API exactamente igual que en una petición directa, así que el servidor no puede hacer nada que tu clave no pudiera hacer.

Necesitas una clave de API con los ámbitos scans:read, scans:write y reference:read. Crea una en Ajustes → Claves de API.

Claude Desktop — añade el servidor a claude_desktop_config.json:

{
  "mcpServers": {
    "namesight": {
      "command": "node",
      "args": ["/path/to/namesight/apps/mcp/dist/main.js"],
      "env": {
        "NAMESIGHT_API_KEY": "ns_live_...",
        "NAMESIGHT_API_URL": "https://api.namesight.app"
      }
    }
  }
}

Claude Code — un solo comando:

claude mcp add namesight \
  --env NAMESIGHT_API_KEY=ns_live_... \
  --env NAMESIGHT_API_URL=https://api.namesight.app \
  -- node ./apps/mcp/dist/main.js

Solo namesight_scan_name gasta algo, y es la única herramienta marcada como de escritura, así que un cliente que pregunte antes de las acciones de escritura preguntará antes de un análisis.

Las listas de referencia también se exponen como recursos — namesight://reference/nice-classes, regions, tlds y adapters — para que el cliente las adjunte una sola vez en lugar de gastar una llamada de herramienta cada vez. El prompt check_brand_name es un brief listo: analiza el nombre, reintenta lo que no se pudo verificar, explica el resultado y propone alternativas si está ocupado.

Cada herramienta declara un esquema de salida y list_scans pagina con cursor y status. Reintentar tras una conexión caída es seguro: el servidor repite la primera respuesta en vez de cobrar dos veces.

Los análisis llevan tiempo, y una llamada a una herramienta devuelve una sola vez. Por defecto, namesight_scan_name devuelve el scanId de inmediato y el asistente lee el resultado con namesight_get_scan.

Pasa waitMs para que el servidor espere en su lugar: consulta hasta que el análisis termina, empezando aproximadamente una vez por segundo y ampliando hasta cinco, y luego devuelve el resultado en línea. Si se agota el margen recibes el análisis parcial en lugar de un error: las comprobaciones que sí terminaron siguen mereciendo la pena.

Una vez conectado el servidor, preguntas en lenguaje natural; el asistente elige las herramientas. Una petición útil menciona las clases o los mercados, porque eso es lo que separa un conflicto real de una marca ajena.

Comprueba si "Lumina Labs" está libre para un estudio de videojuegos
en Turquía y la UE — clases de Niza 9 y 41.

El asistente normalmente consultará las clases con namesight_reference, iniciará el análisis, esperará a que termine y resumirá qué bloquea el nombre y qué no.

Los fallos de la API vuelven como errores de herramienta legibles en lugar de caídas, de modo que el asistente pueda explicar el problema y, cuando sea posible, corregirlo y reintentar.

• 401 — la clave falta, es desconocida, está revocada o ha caducado
• 402 — el plan del espacio de trabajo no incluye la API
• 403 — a la clave le falta un ámbito, o el gasto de créditos está desactivado
• 429 — se superó el límite de peticiones o el saldo de créditos