Nexscope
Start free

Ai Search Citations

seo-ai-mention-history MCP Tool

Monthly absolute mentions from the provider historical database. 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_mention_history
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-mention-history-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_seo_ai_mention_history",
    "arguments": {
      "toMonth": "2025-09",
      "fromMonth": "2025-08",
      "target": [
        {
          "kind": "DOMAIN",
          "domain": " Example.COM "
        }
      ]
    }
  }
}
Legacy endpoint
POST /api/skill-api/v1/mcp
Canonical detail URL
https://www.nexscope.ai/mcp-map/seo-ai-mention-history

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
fromMonthstringrequired
From month value used by this API operation.
Pattern: ^[0-9]{4}-[0-9]{2}$
toMonthstringrequired
To month value used by this API operation.
Pattern: ^[0-9]{4}-[0-9]{2}$

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, items, missing

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
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.measurestringrequired
Measure value used by this API operation.
Constant: monthly_absolute_mentions
data.result.context.fromMonthstringrequired
From month value used by this API operation.
Pattern: ^[0-9]{4}-[0-9]{2}$
data.result.context.toMonthstringrequired
To month value used by this API operation.
Pattern: ^[0-9]{4}-[0-9]{2}$
data.result.context.resolvedDateTostringrequired
Resolved date to value used by this API operation.
Format: date
data.result.context.partialCalendarMonthbooleanrequired
Partial calendar month value used by this API operation.
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.itemsarrayrequired
Items value used by this API operation.
Minimum items: 0
Maximum items: 12
data.result.items[]objectrequired
Item in data result items.
data.result.items[].yearintegerrequired
Year value used by this API operation.
Minimum: 1
data.result.items[].monthintegerrequired
Month value used by this API operation.
Minimum: 1
Maximum: 12
data.result.items[].metricsobjectrequired
Metrics value used by this API operation.
data.result.items[].metrics.mentionsinteger | nullrequired
Mentions value used by this API operation.
Minimum: 0
data.result.items[].metrics.aiSearchVolumeinteger | nullrequired
Ai search volume value used by this API operation.
Minimum: 0
data.result.items[].missingarrayrequired
Missing value used by this API operation.
Minimum items: 0
data.result.items[].missing[]objectrequired
Item in data result items[] missing.
data.result.items[].missing[].fieldstringrequired
Field value used by this API operation.
data.result.items[].missing[].reasonstringrequired
Reason value used by this API operation.
Allowed: UPSTREAM_FIELD_MISSING, UPSTREAM_FIELD_INVALID, DUPLICATE_UPSTREAM_ITEM, UPSTREAM_ITEM_MISSING
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

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

{
  "toMonth": "2025-09",
  "fromMonth": "2025-08",
  "target": [
    {
      "kind": "DOMAIN",
      "domain": " Example.COM "
    }
  ]
}

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
}