API Discovery & Content Evaluation

JEV Evaluate API

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

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-evaluate-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_jev_evaluate",
    "arguments": {
      "useCase": "response_guardrails",
      "input": {
        "content": "Never share passwords. Contact customer support through the official website."
      }
    }
  }
}

Protocol

MCP 2025-11-25 · Streamable HTTP

Canonical detail URL

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

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
`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.

Preset mode

response_guardrails

Name	Type	Required	Description
`useCase`	`string`	optional	Required with input in preset mode. One of seven server-owned presets. Constant: response_guardrails
`input`	`object`	optional	Checks credential_exposure, harmful_instruction, deceptive_claim, instruction_override, and severity. The fixed server policy maps the checks to pass, review, or block.
`input.content`	`string`	required	Authorized response or draft content. Minimum length: 1 Maximum length: 6000

ip_risk_triage

Name	Type

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. Allowed: relevant, irrelevant, uncertain
`data.result.rows[].confidence`	`number`	required	Confidence value used by this API operation. Minimum: 0 Maximum: 1

Examples

Example arguments

{
  "useCase": "response_guardrails",
  "input": {
    "content": "Never share passwords. Contact customer support through the official website."
  }
}

Example structuredContent

{
  "code": 0,
  "msg": "success",
  "data": {
    "useCase": "response_guardrails",
    "policyVersion": "jev-evaluation-v1",
    "model": "<resolved model>",
    "decision": "pass",
    "reasonCodes": [
      "no_rule_triggered"
    ],
    "checks": {},
    "result": {}
  }
}

seo_relevance

Name	Type	Required	Description
`useCase`	`string`	optional	Required with input in preset mode. One of seven server-owned presets. Constant: seo_relevance
`input`	`object`	optional	Requires query and at least one supplied title, metaDescription, or contentExcerpt. Scores relevance only; it does not predict rankings, traffic, search volume, or intent data.
`input.query`	`string`	required	Query value used by this API operation. Minimum length: 1 Maximum length: 500
`input.title`	`string`	optional	Title value used by this API operation. Minimum length: 1 Maximum length: 300
`input.metaDescription`	`string`	optional	Meta description value used by this API operation. Minimum length: 1 Maximum length: 1000
`input.contentExcerpt`	`string`	optional	Content excerpt value used by this API operation. Minimum length: 1 Maximum length: 4000

Any of option 1 — requires title

Name	Type	Required	Description
`input`	`any`	optional	Required with useCase in preset mode. Strict preset-specific input. Keyword presets accept only bounded keyword, candidate, SERP-evidence, and product-fact fields.

Any of option 2 — requires metaDescription

Name	Type	Required	Description
`input`	`any`	optional	Required with useCase in preset mode. Strict preset-specific input. Keyword presets accept only bounded keyword, candidate, SERP-evidence, and product-fact fields.

Any of option 3 — requires contentExcerpt

Name	Type	Required	Description
`input`	`any`

evidence_check

Name	Type	Required	Description
`useCase`	`string`	optional	Required with input in preset mode. One of seven server-owned presets. Constant: evidence_check
`input`	`object`	optional	Assesses the claim only against sourceText. If supplied quote is absent after whitespace normalization, the server returns deterministic quote_not_found without a model call.
`input.claim`	`string`	required	Claim value used by this API operation. Minimum length: 1 Maximum length: 1000
`input.sourceText`	`string`	required	Source text value used by this API operation. Minimum length: 1 Maximum length: 6000
`input.quote`	`string`	optional	Optional quote that must occur in sourceText after whitespace normalization. Minimum length: 1 Maximum length: 1000

keyword_business_relevance

Name	Type	Required	Description
`useCase`	`string`	optional	Required with input in preset mode. One of seven server-owned presets. Constant: keyword_business_relevance
`input`	`object`	optional	Required with useCase in preset mode. Strict preset-specific input. Keyword presets accept only bounded keyword, candidate, SERP-evidence, and product-fact fields.
`input.businessDescription`	`string`	required	Business description value used by this API operation. Minimum length: 1 Maximum length: 4000
`input.exclusions`	`array`	required	Exclusions value used by this API operation. Maximum items: 50
`input.exclusions[]`	`string`	required	Item in input exclusions. Minimum length: 1 Maximum length: 200
`input.keywords`	`array`	required	Keywords value used by this API operation. Minimum items: 1 Maximum items: 10
`input.keywords[]`	`object`	required	Item in input keywords.
`input.keywords[].id`	`string`	required	Id value used by this API operation. Pattern: ^[A-Za-z0-9_-]{1,64}$
`input.keywords[].keyword`	`string`	required	Keyword value used by this API operation. Minimum length: 1 Maximum length: 500
`input.serpEvidence`	`array`	optional	Serp evidence value used by this API operation. Maximum items: 30
`input.serpEvidence[]`	`object`	required	Item in input serpEvidence.
`input.serpEvidence[].id`	`string`	required	Id value used by this API operation. Pattern: ^[A-Za-z0-9_-]{1,64}$
`input.serpEvidence[].keywordId`	`string`	required	Keyword id value used by this API operation. Pattern: ^[A-Za-z0-9_-]{1,64}$
`input.serpEvidence[].source`	`string`	required	Source value used by this API operation. Minimum length: 1 Maximum length: 200
`input.serpEvidence[].text`	`string`	required	Text value used by this API operation. Minimum length: 1 Maximum length: 2000

keyword_cluster_fit

Name	Type	Required	Description
`useCase`	`string`	optional	Required with input in preset mode. One of seven server-owned presets. Constant: keyword_cluster_fit
`input`	`object`	optional	Required with useCase in preset mode. Strict preset-specific input. Keyword presets accept only bounded keyword, candidate, SERP-evidence, and product-fact fields.
`input.keywords`	`array`	required	Keywords value used by this API operation. Minimum items: 1 Maximum items: 10
`input.keywords[]`	`object`	required	Item in input keywords.
`input.keywords[].id`	`string`	required	Id value used by this API operation. Pattern: ^[A-Za-z0-9_-]{1,64}$
`input.keywords[].keyword`	`string`	required	Keyword value used by this API operation. Minimum length: 1 Maximum length: 500
`input.candidates`	`array`	required	Candidates value used by this API operation. Minimum items: 1 Maximum items: 5
`input.candidates[]`	`object`	required	Item in input candidates.
`input.candidates[].id`	`string`	required	Id value used by this API operation. Pattern: ^[A-Za-z0-9_-]{1,64}$
`input.candidates[].keyword`	`string`	required	Keyword value used by this API operation. Minimum length: 1 Maximum length: 500

amazon_keyword_product_fit

Name	Type	Required	Description
`useCase`	`string`	optional	Required with input in preset mode. One of seven server-owned presets. Constant: amazon_keyword_product_fit
`input`	`object`	optional	Required with useCase in preset mode. Strict preset-specific input. Keyword presets accept only bounded keyword, candidate, SERP-evidence, and product-fact fields.
`input.marketplace`	`string`	required	Marketplace value used by this API operation. Allowed: US, UK, DE, FR, JP, CA, IT, ES, MX, IN
`input.productFacts`	`array`	required	Product facts value used by this API operation. Minimum items: 1 Maximum items: 30
`input.productFacts[]`	`object`	required	Item in input productFacts.
`input.productFacts[].id`	`string`	required	Id value used by this API operation. Pattern: ^[A-Za-z0-9_-]{1,64}$
`input.productFacts[].source`	`string`	required	Source value used by this API operation. Allowed: title, bullet, attribute, description
`input.productFacts[].value`	`string`	required	Value value used by this API operation. Minimum length: 1 Maximum length: 2000
`input.keywords`	`array`	required	Keywords value used by this API operation. Minimum items: 1 Maximum items: 10
`input.keywords[]`	`object`	required	Item in input keywords.
`input.keywords[].id`	`string`	required	Id value used by this API operation. Pattern: ^[A-Za-z0-9_-]{1,64}$
`input.keywords[].keyword`	`string`	required	Keyword value used by this API operation. Minimum length: 1 Maximum length: 500

Keyword cluster fit 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[].candidateId`	`string \| null`	required	Candidate id value used by this API operation.
`data.result.rows[].sameTopic`	`boolean`	required	Same topic value used by this API operation.
`data.result.rows[].samePage`	`boolean`	required	Same page value used by this API operation.
`data.result.rows[].label`	`string`	required	Label value used by this API operation. Allowed: same_page, separate_page, uncertain
`data.result.rows[].confidence`	`number`	required	Confidence value used by this API operation. Minimum: 0 Maximum: 1
`data.result.rows[].reasonCodes`	`array`	required	Reason codes value used by this API operation.
`data.result.rows[].reasonCodes[]`	`string`	required	Item in data result rows[] reasonCodes.

Amazon keyword product fit 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. Allowed: match, partial, conflict, unknown
`data.result.rows[].confidence`	`number`	required	Confidence value used by this API operation. Minimum: 0 Maximum: 1
`data.result.rows[].reasonCodes`	`array`	required	Reason codes value used by this API operation.
`data.result.rows[].reasonCodes[]`	`string`	required	Item in data result rows[] reasonCodes.
`data.result.rows[].evidenceRefs`	`array`	required	Evidence refs value used by this API operation.
`data.result.rows[].evidenceRefs[]`	`string`	required	Item in data result rows[] evidenceRefs.

JEV Evaluate API

JEV Evaluate API

Authentication

Call this MCP tool

Arguments

Preset mode

response_guardrails

ip_risk_triage

Response fields

Business relevance row

Examples

Example arguments

Example structuredContent

Related MCP tools

seo_relevance

Any of option 1 — requires title

Any of option 2 — requires metaDescription

Any of option 3 — requires contentExcerpt

evidence_check

keyword_business_relevance

keyword_cluster_fit

amazon_keyword_product_fit

Custom mode

Keyword cluster fit row

Amazon keyword product fit row