API Discovery & Content Evaluation

JEV Route API

Discover a published Nexscope data API or one of seven fixed JEV evaluation presets without executing the match. The routing intent is sent to TypeSafe for evaluation. Requires an active Nexscope subscription. Each route or evaluate call deducts 1 Nexscope credit; any selected data API retains its existing billing. Route and evaluate share limits of 20 requests per user per minute, 200 requests globally per minute, and 5,000 requests globally per rolling day; each route or evaluate call counts as one request.

MCP tool name

nexscope_route_api

MCP endpoint

https://api.nexscope.ai/api/skill-api/v2/mcp

JSON-RPC method

tools/call

Authentication

Use OAuth 2.1 Authorization Code with PKCE and the mcp:tools scope for standard remote clients. API keys remain supported as a compatibility option while v1 integrations migrate.

Authorization: Bearer nk-xxxxxxxxxxxxxxxxx

If authentication is missing or invalid, ask the user to open API Access and copy a valid key before calling this tool.

Call this MCP tool

Initialize an MCP 2025-11-25 Streamable HTTP session at https://api.nexscope.ai/api/skill-api/v2/mcp, then use tools/call with the MCP tool name below. The arguments object should match the table on this page.

{
  "jsonrpc": "2.0",
  "id": "jev-route-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_route_api",
    "arguments": {
      "intent": "Fetch Amazon product reviews by ASIN so I can analyze customer pain points",
      "categorySlug": "amazon-marketplace-intelligence"
    }
  }
}

Protocol

MCP 2025-11-25 · Streamable HTTP

Canonical detail URL

https://www.nexscope.ai/mcp-map/jev-route

Progress is delivered on the original POST SSE response when the client supplies a progress token and the tool has real execution stages. GET SSE carries server notifications such as tool-list changes. Creating an asynchronous task or calling an external provider may consume credits; reconnecting must query the existing task instead of submitting it again.

Arguments

Name	Type	Required	Description
`intent`	`string`	required	One routing intent. It is used only for discovery and is never converted into API or evaluation input. Example: Fetch Amazon product reviews by ASIN so I can analyze customer pain points
`categorySlug`	`string`	optional	Optional current public catalog category, or jev-evaluation to limit discovery to the fixed presets. Example: amazon-marketplace-intelligence

Response fields

Treat structuredContent as the programmatic API response payload.

Name	Type	Required	Description
`code`	`integer`	required	Zero on success; non-zero for validation, access, quota, or availability errors.
`msg`	`string`	required	Response message.
`data`	`object`	required	For matched, call the returned endpoint separately after collecting its required fields. For ambiguous, ask the user to clarify and route again. For no_match, do not invent or execute a capability.
`data.status`	`string`	required	Status value used by this API operation. Allowed: matched, ambiguous, no_match
`data.catalogVersion`	`string`	required	Catalog timestamp used for this routing decision.
`data.policyVersion`	`string`	required	Server-owned routing policy version.
`data.models`	`array`	required	Resolved model versions used by the routing stages.
`data.models[]`	`string`	required	Item in data models.
`data.confidence`	`number \| null`	required	Confidence value used by this API operation. Minimum: 0 Maximum: 1
`data.match`	`any`	required	Match value used by this API operation.
`data.candidates`	`array`	required	Up to three clarification candidates for an ambiguous result.
`data.candidates[]`	`object`	required	Item in data candidates.
`data.reason`	`string`	required	Reason value used by this API operation. Allowed: matched, clarification_required, no_supported_api

Published data API match

Name	Type	Required	Description
`data.match`	`object`	required	Match value used by this API operation.
`data.match.kind`	`string`	required	Kind value used by this API operation. Constant: skill_api
`data.match.slug`	`string`	required	Slug value used by this API operation.
`data.match.name`	`string`	required	Name value used by this API operation.
`data.match.method`	`string`	required

Examples

Example arguments

{
  "intent": "Fetch Amazon product reviews by ASIN so I can analyze customer pain points",
  "categorySlug": "amazon-marketplace-intelligence"
}

Example structuredContent

{
  "code": 0,
  "msg": "success",
  "data": {
    "status": "matched",
    "catalogVersion": "<catalog version>",
    "policyVersion": "jev-routing-v2",
    "models": [
      "<resolved model>"
    ],
    "confidence": 0.91,
    "match": {
      "kind": "skill_api",
      "slug": "amazon-reviews-list",
      "name": "Amazon Reviews List",
      "method": "POST",
      "endpoint": "/api/skill-api/v1/skills/amazon-reviews-list/run",
      "mcpToolName": "nexscope_amazon_reviews_list",
      "schemaEndpoint": "/api/skill-api/v1/skills/amazon-reviews-list",
      "docsPath": "/api-docs/amazon-reviews-list?view=api"
    },
    "candidates": [],
    "reason": "matched"
  }
}

Fixed JEV use-case match

Name	Type	Required	Description
`data.match`	`object`	required	Match value used by this API operation.
`data.match.kind`	`string`	required	Kind value used by this API operation. Constant: jev_use_case
`data.match.name`	`string`	required	Name value used by this API operation.
`data.match.method`	`string`	required	Method value used by this API operation. Constant: POST
`data.match.endpoint`	`string`	required	Endpoint value used by this API operation.
`data.match.mcpToolName`	`string`	required	Mcp tool name value used by this API operation.
`data.match.useCase`	`string`	required	Use case value used by this API operation.
`data.match.schemaEndpoint`	`string`	required	Schema endpoint value used by this API operation.
`data.match.schemaPointer`	`string`	required	Schema pointer value used by this API operation.
`data.match.docsPath`	`string`	required	Docs path value used by this API operation.

JEV Route API

JEV Route API

Authentication

Call this MCP tool

Arguments

Response fields

Published data API match

Examples

Example arguments

Example structuredContent

Related MCP tools

Fixed JEV use-case match

One of option 3