JEV

JEV Evaluate API MCP Tool

Evaluate authorized content using seven presets or custom state and typed questions. Submitted fields are 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_jev_evaluate

MCP endpoint

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

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

JEV

JEV Evaluate API MCP Tool

MCP tool name

nexscope_jev_evaluate

MCP endpoint

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

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

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	Fixed server policies cover response safety, IP triage, SEO relevance, evidence checks, business-keyword relevance, keyword same-page clustering, and Amazon product-keyword fit. Keyword presets return bounded rows keyed only by caller-supplied IDs.
`data.useCase`	`string`	required	Use case value used by this API operation. Allowed: response_guardrails, ip_risk_triage, seo_relevance, evidence_check, keyword_business_relevance, keyword_cluster_fit, amazon_keyword_product_fit, custom
`data.policyVersion`	`string`	required	jev-evaluation-v1 for original presets; jev-keyword-tools-v1 for keyword presets; jev-custom-v1 for custom questions.
`data.model`	`string \| null`	required	Resolved model version, or null for deterministic quote_not_found.
`data.decision`	`string`	required	Presets return pass/review/block. Custom mode returns evaluated, which means answers are available, not that an action is approved. Allowed: pass, review, block, evaluated
`data.reasonCodes`	`array`	required	Fixed reason codes without submitted text.
`data.reasonCodes[]`	`string`	required	Item in data reasonCodes.
`data.checks`	`object`	required	Empty in custom mode; answers are in result.answers. Fixed Noul, Score, or Choice checks for the preset: response risks and severity; IP signals, risk_type, severity, and insufficient_context; supplied SEO dimensions; or evidence verdict. Deterministic quote_not_found returns an empty object.
`data.result`	`object`	required	Preset-specific bounded result. Keyword presets return result.rows with caller-supplied IDs, fixed labels, confidence, and fixed reason or evidence references.
`data.result.answers`	`object`	optional	Custom mode only. Answers keyed by question ID: noul returns {type, noul}; choice returns {type, choice, confidence, probabilities}; score returns {type, score, confidence, probabilities, legend}. No automatic policy or token usage is returned.
`data.result.rows`	`array`	optional	Rows value used by this API operation. Maximum items: 10
`data.result.rows[]`	`any`	required	Item in data result rows.

Business relevance row

Name	Type	Required	Description
`data.result.rows[]`	`object`	required	Item in data result rows.
`data.result.rows[].id`	`string`	required	Id value used by this API operation. Pattern: ^[A-Za-z0-9_-]{1,64}$
`data.result.rows[].label`	`string`	required	Label value used by this API operation.

JEV Evaluate API MCP Tool

Authentication

JEV Evaluate API MCP Tool

Authentication

Call this MCP tool

Arguments

Preset mode

response_guardrails

Response fields

Business relevance row

Examples

Example arguments

Example structuredContent

ip_risk_triage

seo_relevance

Any of option 1 — requires title

Any of option 2 — requires metaDescription

evidence_check

keyword_business_relevance

keyword_cluster_fit

amazon_keyword_product_fit

Custom mode

Keyword cluster fit row

Amazon keyword product fit row

Any of option 3 — requires contentExcerpt

Name	Type	Required	Description
`useCase`	`string`	optional	Required with input in preset mode. One of seven server-owned presets. Allowed: response_guardrails, ip_risk_triage, seo_relevance, evidence_check, keyword_business_relevance, keyword_cluster_fit, amazon_keyword_product_fit
`input`	`object`	optional	Fields depend on the selected preset; see the mode schemas below.
`state`	`string \| object \| array`	optional	Required in custom mode. Non-empty context shared by every question; supplied data is sent to TypeSafe. Minimum length: 1 Minimum items: 1
`questions`	`object`	optional	Required in custom mode. 1–32 independent questions, keyed by caller-defined IDs.

JEV Evaluate API MCP Tool

Authentication

JEV Evaluate API MCP Tool

Authentication

Call this MCP tool

Arguments

Preset mode

response_guardrails

Response fields

Business relevance row

Examples

Example arguments

Example structuredContent

Related MCP tools

ip_risk_triage

seo_relevance

Any of option 1 — requires title

Any of option 2 — requires metaDescription

evidence_check

keyword_business_relevance

keyword_cluster_fit

amazon_keyword_product_fit

Custom mode

Keyword cluster fit row

Amazon keyword product fit row

Any of option 3 — requires contentExcerpt