Nexscope
Start free

Ai Search Citations

seo-ai-target-metrics MCP Tool

AI target metrics from provider database aggregates. Historical provider database facts, not a live model execution. Domain filters use cited sources and keyword filters use answer text. Preserve nullable evidence and unsupported dimensions.

MCP tool name
nexscope_seo_ai_target_metrics
Legacy MCP endpoint
/api/skill-api/v1/mcp
JSON-RPC method
tools/call

Authentication

Send the user API key as a bearer token on every MCP JSON-RPC request.

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

Use tools/call with the MCP tool name below. The arguments object should match the table on this page.

{
  "jsonrpc": "2.0",
  "id": "seo-ai-target-metrics-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_seo_ai_target_metrics",
    "arguments": {
      "target": [
        {
          "kind": "DOMAIN",
          "domain": " Example.COM "
        },
        {
          "kind": "KEYWORD",
          "keyword": " Shoes "
        }
      ]
    }
  }
}
Legacy endpoint
POST /api/skill-api/v1/mcp
Canonical detail URL
https://www.nexscope.ai/mcp-map/seo-ai-target-metrics

Arguments

NameTypeRequiredDescription
targetarrayrequired
Target value used by this API operation.
Minimum items: 1
Maximum items: 10
target[]anyrequired
Item in target.
marketstringoptional
Market value used by this API operation.
Constant: US
Default: US
languagestringoptional
Language value used by this API operation.
Constant: en
Default: en
platformstringoptional
Platform value used by this API operation.
Allowed: google, chat_gpt
Default: google

One of option 1 — requires kind, domain

NameTypeRequiredDescription
target[]objectrequired
Item in target.
target[].kindstringrequired
Kind value used by this API operation.
Constant: DOMAIN
target[].domainstringrequired
Normalized ASCII hostname at most63 characters.
Minimum length: 1
target[].searchFilterstringoptional
Search filter value used by this API operation.
Allowed: include, exclude
Default: include
target[].includeSubdomainsbooleanoptional
Include subdomains value used by this API operation.
Default: false

One of option 2 — requires kind, keyword

NameTypeRequiredDescription
target[]objectrequired
Item in target.
target[].kindstringrequired
Kind value used by this API operation.
Constant: KEYWORD
target[].keywordstringrequired
Trim/NFC/lowercase1..80 code points,max10 words,no ASCII percent or plus.
Minimum length: 1
target[].searchFilterstringoptional
Search filter value used by this API operation.
Allowed: include, exclude
Default: include
target[].matchTypestringoptional
Match type value used by this API operation.
Allowed: word_match, partial_match
Default: word_match

Response fields

Treat structuredContent as the programmatic API response payload.

NameTypeRequiredDescription
dataanyrequired
Data value used by this API operation.
codeintegerrequired
0 means accepted or successful; nonzero is a platform error.
msgstring | nullrequired
Msg value used by this API operation.
tsstringrequired
Epoch milliseconds.
timestringrequired
Server local time: yyyy-MM-dd HH:mm:ss.
coststringrequired
Elapsed milliseconds, never credits; -1 outside web requests.
traceIdstring | nullrequired
Trace id value used by this API operation.

Any of option 1

NameTypeRequiredDescription
dataanyrequired
Data value used by this API operation.

One of option 1 — requires callId, status, result

NameTypeRequiredDescription
dataobjectrequired
Data value used by this API operation.
data.resultanyrequired
Result value used by this API operation.
data.callIdstringrequired
Call id value used by this API operation.
data.schemaVersionstringoptional
Schema version value used by this API operation.
data.statusstringrequired
Status value used by this API operation.
data.sourcestringoptional
Source value used by this API operation.
data.requestedAtstring | integer | nulloptional
Requested at value used by this API operation.
data.completedAtstring | integer | nulloptional
Completed at value used by this API operation.
data.coverageobject | nulloptional
Coverage value used by this API operation.
data.usageobject | nulloptional
Usage value used by this API operation.
data.usage.billingStatusstring | nulloptional
Billing status value used by this API operation.
data.usage.chargedCreditsstring | integer | nulloptional
Charged credits value used by this API operation.

Any of option 1 — requires market, language, sourceProduct, sourceKind, context, returnedCount, truncated, missing, metrics

NameTypeRequiredDescription
data.resultobjectrequired
Result value used by this API operation.
data.result.marketstringrequired
Market value used by this API operation.
Constant: US
data.result.languagestringrequired
Language value used by this API operation.
Constant: en
data.result.sourceProductstringrequired
Source product value used by this API operation.
Constant: ai_optimization
data.result.sourceKindstringrequired
Source kind value used by this API operation.
Constant: llm_mentions_database
data.result.contextobjectrequired
Context value used by this API operation.
data.result.context.inputTargetsarrayrequired
Input targets value used by this API operation.
Minimum items: 1
Maximum items: 10
data.result.context.inputTargets[]anyrequired
Item in data result context inputTargets.
data.result.context.normalizedTargetsarrayrequired
Normalized targets value used by this API operation.
Minimum items: 1
Maximum items: 10
data.result.context.normalizedTargets[]anyrequired
Item in data result context normalizedTargets.
data.result.context.platformstringrequired
Platform value used by this API operation.
Allowed: google, chat_gpt
Default: google
data.result.context.domainSearchScopestringrequired
Domain search scope value used by this API operation.
Constant: sources
data.result.context.keywordSearchScopestringrequired
Keyword search scope value used by this API operation.
Constant: answer
data.result.context.unsupportedDimensionsarrayrequired
Unsupported dimensions value used by this API operation.
Minimum items: 0
Maximum items: 3
data.result.context.unsupportedDimensions[]stringrequired
Item in data result context unsupportedDimensions.
Allowed: searchResultDomains, brands, brandCategories
data.result.returnedCountintegerrequired
Returned count value used by this API operation.
Minimum: 0
data.result.truncatedbooleanrequired
Truncated value used by this API operation.
data.result.missingarrayrequired
Missing value used by this API operation.
Minimum items: 0
data.result.missing[]objectrequired
Item in data result missing.
data.result.missing[].fieldstringrequired
Field value used by this API operation.
data.result.missing[].reasonstringrequired
Reason value used by this API operation.
Allowed: UPSTREAM_FIELD_MISSING, UPSTREAM_FIELD_INVALID, DUPLICATE_UPSTREAM_ITEM, UPSTREAM_ITEM_MISSING
data.result.metricsobjectrequired
Metrics value used by this API operation.
data.result.metrics.totalobjectrequired
Total value used by this API operation.
data.result.metrics.total.mentionsinteger | nullrequired
Mentions value used by this API operation.
Minimum: 0
data.result.metrics.total.aiSearchVolumeinteger | nullrequired
Ai search volume value used by this API operation.
Minimum: 0
data.result.metrics.sourceDomainsarray | nullrequired
Source domains value used by this API operation.
Minimum items: 0
Maximum items: 10
data.result.metrics.sourceDomains[]objectrequired
Item in data result metrics sourceDomains.
data.result.metrics.sourceDomains[].domainstringrequired
Domain value used by this API operation.
data.result.metrics.sourceDomains[].countsobjectrequired
Counts value used by this API operation.
data.result.metrics.sourceDomains[].counts.mentionsinteger | nullrequired
Mentions value used by this API operation.
Minimum: 0
data.result.metrics.sourceDomains[].counts.aiSearchVolumeinteger | nullrequired
Ai search volume value used by this API operation.
Minimum: 0
data.result.metrics.searchResultDomainsarray | nullrequired
Search result domains value used by this API operation.
Minimum items: 0
Maximum items: 10
data.result.metrics.searchResultDomains[]objectrequired
Item in data result metrics searchResultDomains.
data.result.metrics.searchResultDomains[].domainstringrequired
Domain value used by this API operation.
data.result.metrics.searchResultDomains[].countsobjectrequired
Counts value used by this API operation.
data.result.metrics.searchResultDomains[].counts.mentionsinteger | nullrequired
Mentions value used by this API operation.
Minimum: 0
data.result.metrics.searchResultDomains[].counts.aiSearchVolumeinteger | nullrequired
Ai search volume value used by this API operation.
Minimum: 0
data.result.metrics.brandsarray | nullrequired
Brands value used by this API operation.
Minimum items: 0
Maximum items: 10
data.result.metrics.brands[]objectrequired
Item in data result metrics brands.
data.result.metrics.brands[].valuestringrequired
Value value used by this API operation.
data.result.metrics.brands[].countsobjectrequired
Counts value used by this API operation.
data.result.metrics.brands[].counts.mentionsinteger | nullrequired
Mentions value used by this API operation.
Minimum: 0
data.result.metrics.brands[].counts.aiSearchVolumeinteger | nullrequired
Ai search volume value used by this API operation.
Minimum: 0
data.result.metrics.brandCategoriesarray | nullrequired
Brand categories value used by this API operation.
Minimum items: 0
Maximum items: 10
data.result.metrics.brandCategories[]objectrequired
Item in data result metrics brandCategories.
data.result.metrics.brandCategories[].valuestringrequired
Value value used by this API operation.
data.result.metrics.brandCategories[].countsobjectrequired
Counts value used by this API operation.
data.result.metrics.brandCategories[].counts.mentionsinteger | nullrequired
Mentions value used by this API operation.
Minimum: 0
data.result.metrics.brandCategories[].counts.aiSearchVolumeinteger | nullrequired
Ai search volume value used by this API operation.
Minimum: 0

One of option 1 — requires kind, domain, searchFilter, includeSubdomains

NameTypeRequiredDescription
data.result.context.inputTargets[]objectrequired
Item in data result context inputTargets.
data.result.context.inputTargets[].kindstringrequired
Kind value used by this API operation.
Constant: DOMAIN
data.result.context.inputTargets[].domainstringrequired
Normalized ASCII hostname at most63 characters.
Minimum length: 1
data.result.context.inputTargets[].searchFilterstringrequired
Search filter value used by this API operation.
Allowed: include, exclude
Default: include
data.result.context.inputTargets[].includeSubdomainsbooleanrequired
Include subdomains value used by this API operation.
Default: false

One of option 2 — requires kind, keyword, searchFilter, matchType

NameTypeRequiredDescription
data.result.context.inputTargets[]objectrequired
Item in data result context inputTargets.
data.result.context.inputTargets[].kindstringrequired
Kind value used by this API operation.
Constant: KEYWORD
data.result.context.inputTargets[].keywordstringrequired
Trim/NFC/lowercase1..80 code points,max10 words,no ASCII percent or plus.
Minimum length: 1
data.result.context.inputTargets[].searchFilterstringrequired
Search filter value used by this API operation.
Allowed: include, exclude
Default: include
data.result.context.inputTargets[].matchTypestringrequired
Match type value used by this API operation.
Allowed: word_match, partial_match
Default: word_match

One of option 1 — requires kind, domain, searchFilter, includeSubdomains

NameTypeRequiredDescription
data.result.context.normalizedTargets[]objectrequired
Item in data result context normalizedTargets.
data.result.context.normalizedTargets[].kindstringrequired
Kind value used by this API operation.
Constant: DOMAIN
data.result.context.normalizedTargets[].domainstringrequired
Normalized ASCII hostname at most63 characters.
Minimum length: 1
data.result.context.normalizedTargets[].searchFilterstringrequired
Search filter value used by this API operation.
Allowed: include, exclude
Default: include
data.result.context.normalizedTargets[].includeSubdomainsbooleanrequired
Include subdomains value used by this API operation.
Default: false

One of option 2 — requires kind, keyword, searchFilter, matchType

NameTypeRequiredDescription
data.result.context.normalizedTargets[]objectrequired
Item in data result context normalizedTargets.
data.result.context.normalizedTargets[].kindstringrequired
Kind value used by this API operation.
Constant: KEYWORD
data.result.context.normalizedTargets[].keywordstringrequired
Trim/NFC/lowercase1..80 code points,max10 words,no ASCII percent or plus.
Minimum length: 1
data.result.context.normalizedTargets[].searchFilterstringrequired
Search filter value used by this API operation.
Allowed: include, exclude
Default: include
data.result.context.normalizedTargets[].matchTypestringrequired
Match type value used by this API operation.
Allowed: word_match, partial_match
Default: word_match

Any of option 2

NameTypeRequiredDescription
data.resultnullrequired
Result value used by this API operation.

One of option 2 — requires callId, status, reason, retryable

NameTypeRequiredDescription
dataobjectrequired
Data value used by this API operation.
data.reasonstringrequired
Reason value used by this API operation.
data.callIdstring | nullrequired
Call id value used by this API operation.
data.statusstringrequired
Status value used by this API operation.
data.retryablebooleanrequired
Retryable value used by this API operation.
data.taskIdstring | nulloptional
Task id value used by this API operation.

Any of option 2

NameTypeRequiredDescription
datanullrequired
Data value used by this API operation.

Examples

Example arguments

{
  "target": [
    {
      "kind": "DOMAIN",
      "domain": " Example.COM "
    },
    {
      "kind": "KEYWORD",
      "keyword": " Shoes "
    }
  ]
}

Example structuredContent

{
  "data": {
    "status": "PROCESSING",
    "retryable": false,
    "reason": "IN_PROGRESS",
    "callId": "00000000-0000-4000-8000-000000000001"
  },
  "code": 0,
  "msg": null,
  "ts": "0",
  "time": "2026-01-01 00:00:00",
  "cost": "-1",
  "traceId": null
}