JEV
API de enrutamiento de JEV MCP
Rutas una intención de confiar en los metadatos para los datos publicados API o fijos JEV Preset. La intención de pudrir es enviada a TypeSafe para la evaluación. Los resultados ambiguos requieren aclaración; el enrutamiento nunca ejecuta un partido, genera la entrada de evaluación o llena los parámetros perdidos. Requiere un activo Nexscope suscripción. Cada ruta o evaluar deducciones de llamadas 1 Nexscope credit; cualquier dato seleccionado API conserva su facturación existente. Ruta y evaluación de límites de acciones de 20 solicitudes por usuario por minuto, 200 solicitudes a nivel mundial por minuto, y 5.000 solicitudes a nivel mundial por día de rodaje; cada ruta o evaluación de llamadas cuenta como una solicitud. La admisión Quota es secuencial: minuto por usuario, minuto global, luego día de rodadura global; un mostrador admitido anteriormente sigue aumentado si un cheque posterior rechaza la solicitud.
Prompts y casos de uso de API de enrutamiento de JEV
Después de conectar esta herramienta MCP a tu asistente de IA, puedes plantear las preguntas siguientes. Sustituye los marcadores entre corchetes por tus datos y usa los valores admitidos en Argumentos.
¿Es tu primera vez con Nexscope MCP? Sigue la guía de conexión, y después usa los prompts siguientes. Las pestañas Integración y Parámetros y respuesta contienen los pasos de conexión, un ejemplo de llamada y la referencia técnica.
1. Encontrar una herramienta para una tarea de investigación
Prompt: Encontrar una herramienta publicada [research intent]. Mostrar el partido devuelto o los candidatos y pedir aclaraciones si la intención es ambigua. No ejecutar la herramienta sugerida.
2. Encontrar una herramienta dentro de una categoría
Prompt: Encontrar una herramienta publicada [research intent] dentro [current catalog category]. Mantenga el descubrimiento separado de cualquier ejecución posterior de la herramienta.
3. Encontrar un Presto de Evaluación Adecuado
Prompt: Encontrar un preset de evaluación fijo [evaluation intent]. Mostrar la información predeterminada pertinente sin convertir mi intención en una solicitud de evaluación.
Qué debes proporcionar
Paso 1 · Conectar
Conecta tu asistente de IA
Conecta un cliente MCP compatible a Nexscope y selecciona esta herramienta en tu asistente. Completa la autenticación en la configuración de conexión del cliente.
POST https://api.nexscope.ai/mcp
MCP-Protocol-Version: 2025-11-25
Content-Type: application/jsonAutenticación
Usa el código de autorización OAuth 2.1 con PKCE y el ámbito mcp:tools. Las claves de API siguen siendo una opción de compatibilidad admitida.
Authorization: Bearer nk-xxxxxxxxxxxxxxxxx¿Usas una clave de API? Obtén tu clave en Acceso a la API e inclúyela en el encabezado Authorization que se muestra arriba.
Llamar a esta herramienta MCP
nexscope_route_apihttps://api.nexscope.ai/mcptools/callInicializa una sesión HTTP Streamable MCP 2025-11-25 en https://api.nexscope.ai/mcp y después usa tools/call.
{
"jsonrpc": "2.0",
"id": "jev-route-1",
"method": "tools/call",
"params": {
"name": "nexscope_route_api",
"arguments": {
"categorySlug": "amazon-marketplace-intelligence",
"intent": "Fetch Amazon product reviews by ASIN so I can analyze customer pain points"
}
}
}MCP 2025-11-25 · Streamable HTTPLa respuesta SSE del POST inicial comunica el progreso. El flujo SSE por GET transmite notificaciones; si se restablece la conexión, consulta la tarea asíncrona existente en vez de enviarla de nuevo.
Argumentos
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
intent | string | obligatorio | Una intención routing. Se utiliza sólo para el descubrimiento y nunca se convierte en API o aporte de evaluación. Ejemplo: Fetch Amazon product reviews by ASIN so I can analyze customer pain points |
categorySlug | string | opcional | Opcional categoría actual de catálogo público, o jev-evaluation para limitar el descubrimiento a los presets fijos. Ejemplo: amazon-marketplace-intelligence |
Campos de respuesta
Usa structuredContent como los datos de respuesta de la API para el procesamiento programático.
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
code | integer | obligatorio | Cero sobre el éxito; no cero para errores de validación, acceso, cuota o disponibilidad. |
data | object | obligatorio | Para igualar, llame al punto final devuelto por separado después de recoger sus campos requeridos. Para ambiguo, pida al usuario que aclare y dirija de nuevo. Para no_match, no inventar o ejecutar una capacidad. |
data.candidates | array | obligatorio | Hasta tres candidatos de aclaración para un resultado ambiguo. |
data.candidates[] | object | obligatorio | Hasta tres candidatos de aclaración para un resultado ambiguo. |
data.catalogVersion | string | obligatorio | Timetamp de catálogo utilizado para esta decisión de enrutamiento. |
data.confidence | number | null | obligatorio | Valor de Confidence usado por esta operación de API. Mínimo: 0 Máximo: 1 |
data.match | any | obligatorio | Null for ambiguous and no_match respuestas. |
data.models | array | obligatorio | Versiones modelo resueltas utilizadas por las etapas de enrutamiento. |
data.models[] | string | obligatorio | Versiones modelo resueltas utilizadas por las etapas de enrutamiento. |
data.policyVersion | string | obligatorio | Versión de política de enrutamiento propiedad del servidor. |
data.reason | string | obligatorio | Valor de Reason usado por esta operación de API. Permitidos: matched, clarification_required, no_supported_api |
data.status | string | obligatorio | Valor de Status usado por esta operación de API. Permitidos: matched, ambiguous, no_match |
msg | string | obligatorio | Mensaje de respuesta. |
Published data API match
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
data.match | object | obligatorio | Null for ambiguous and no_match respuestas. |
data.match.docsPath | string | obligatorio | Valor de Docs path usado por esta operación de API. |
data.match.endpoint | string | obligatorio | Valor de Endpoint usado por esta operación de API. |
data.match.kind | string | obligatorio | Valor de Kind usado por esta operación de API. Constante: skill_api |
data.match.mcpToolName | string | obligatorio | Valor de Mcp tool name usado por esta operación de API. |
data.match.method | string | obligatorio | Valor de Method usado por esta operación de API. Constante: POST |
data.match.name | string | obligatorio | Valor de Name usado por esta operación de API. |
data.match.schemaEndpoint | string | obligatorio | Valor de Schema endpoint usado por esta operación de API. |
data.match.slug | string | obligatorio | Valor de Slug usado por esta operación de API. |
Fixed JEV use-case match
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
data.match | object | obligatorio | Null for ambiguous and no_match respuestas. |
data.match.docsPath | string | obligatorio | Valor de Docs path usado por esta operación de API. |
data.match.endpoint | string | obligatorio | Valor de Endpoint usado por esta operación de API. |
data.match.kind | string | obligatorio | Valor de Kind usado por esta operación de API. Constante: jev_use_case |
data.match.mcpToolName | string | obligatorio | Valor de Mcp tool name usado por esta operación de API. |
data.match.method | string | obligatorio | Valor de Method usado por esta operación de API. Constante: POST |
data.match.name | string | obligatorio | Valor de Name usado por esta operación de API. |
data.match.schemaEndpoint | string | obligatorio | Valor de Schema endpoint usado por esta operación de API. |
data.match.schemaPointer | string | obligatorio | Valor de Schema pointer usado por esta operación de API. |
data.match.useCase | string | obligatorio | Valor de Use case usado por esta operación de API. |
Opción 3 de una alternativa
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
data.match | null | obligatorio | Null for ambiguous and no_match respuestas. |
Ilustración del formato
Ejemplo ilustrativo con datos ficticios, no una llamada en vivo a la herramienta.
Pregunta ilustrativa
Encontrar una herramienta para recuperar las reseñas de productos de Amazon por ASIN para la investigación del cliente-pain-point.
Explicación ilustrativa de la respuesta
La ruta ilustrativa apunta a Amazon Reviews List. Esto es sólo metadatos de descubrimiento: no ASIN ha sido preguntado y no se ha realizado ningún análisis de revisión.
Sobre esta muestra: Ejemplo de formato ilustrativo con valores ficticios, no una llamada de herramienta en vivo. Sustitúyase entradas de ejemplo con sus propios activos permitidos o identificadores públicos. Las etiquetas modelo y catálogo en esta ilustración son ficticias, no identificadores para seleccionar para una solicitud en vivo.
No hay datos de ejemplo publicados para esta página. Una ilustración del formato o una guía de flujo de trabajo no sustituye un resultado publicado.
Ver el formato de solicitud y respuesta MCP
Ejemplos
Ejemplo ilustrativo con datos ficticios, no una llamada en vivo a la herramienta.
La estructura JSON-RPC siguiente muestra cómo se presentan en MCP los argumentos y los datos indicados. No procede de una captura de tráfico ni demuestra que la llamada se haya completado. Los ejemplos de flujo de trabajo no muestran un resultado.
Solicitud MCP
{
"jsonrpc": "2.0",
"id": "jev-route-example",
"method": "tools/call",
"params": {
"name": "nexscope_route_api",
"arguments": {
"categorySlug": "amazon-marketplace-intelligence",
"intent": "Fetch Amazon product reviews by ASIN so I can analyze customer pain points"
}
}
}Formato de respuesta MCP
{
"jsonrpc": "2.0",
"id": "jev-route-example",
"result": {
"content": [
{
"type": "text",
"text": "{\"code\":0,\"data\":{\"candidates\":[],\"catalogVersion\":\"example-catalog-version\",\"confidence\":0.91,\"match\":{\"docsPath\":\"/api-docs/amazon-reviews-list?view=api\",\"endpoint\":\"/api/skill-api/v1/skills/amazon-reviews-list/run\",\"kind\":\"skill_api\",\"mcpToolName\":\"nexscope_amazon_reviews_list\",\"method\":\"POST\",\"name\":\"Amazon Reviews List\",\"schemaEndpoint\":\"/api/skill-api/v1/skills/amazon-reviews-list\",\"slug\":\"amazon-reviews-list\"},\"models\":[\"example-model\"],\"policyVersion\":\"jev-routing-v2\",\"reason\":\"matched\",\"status\":\"matched\"},\"msg\":\"success\"}"
}
],
"structuredContent": {
"code": 0,
"data": {
"candidates": [],
"catalogVersion": "example-catalog-version",
"confidence": 0.91,
"match": {
"docsPath": "/api-docs/amazon-reviews-list?view=api",
"endpoint": "/api/skill-api/v1/skills/amazon-reviews-list/run",
"kind": "skill_api",
"mcpToolName": "nexscope_amazon_reviews_list",
"method": "POST",
"name": "Amazon Reviews List",
"schemaEndpoint": "/api/skill-api/v1/skills/amazon-reviews-list",
"slug": "amazon-reviews-list"
},
"models": [
"example-model"
],
"policyVersion": "jev-routing-v2",
"reason": "matched",
"status": "matched"
},
"msg": "success"
},
"isError": false
}
}