Skip to content
ToolCargo

Docs · Updated 2026-10-03

Wikidata Entity Research — tool reference

Identify an entity, then inspect what the source actually claims.

Server URL: https://toolcargo.com/mcp/wikidata · Scope: connector:wikidata. Activate Site Audit free and use ToolCargo OAuth or a scoped API key. No Wikidata credentials are required. Each successful operation uses one shared-plan call.

wd_search_entities

input
{ "query": "مصر", "language": "ar", "limit": 5, "offset": 0 }

Search plain 2–200 character labels and aliases in English or Arabic. Results are identity candidates: inspect the exact item before choosing one. Search display and match language provenance are preserved; the provider’s raw label or description may use a fallback language. Ranking does not prove identity.

Each explicit page returns at most ten candidates. Use nextOffset with unchanged query, language and limit. Offsets are bounded to 0–1000; no automatic pagination or completeness guarantee. Counts are not invented.

wd_entity_details

input
{ "entityId": "Q79", "language": "ar" }

Use an exact Q item ID. Returns selected English and Arabic labels, descriptions and up to twenty aliases per language. Requested-language selection has no silent fallback: missing labels or descriptions stay null. Revision and modification metadata are exposed when supplied; identities that redirect to another item are not silently accepted.

Selected English/Arabic Wikipedia sitelinks contain page titles and safely constructed source links. These identify pages only; no article contents are fetched. This lookup is current metadata, not a guarantee that a later statement request has the same revision.

wd_entity_statements

input
{ "entityId": "Q42", "propertyId": "P569", "limit": 5, "offset": 0 }

Inspect one exact P property on one exact Q item. The provider returns that property’s full claim array; ToolCargo exposes one explicit local page of at most ten statements and a total count. Offset 0–1000; ordering and counts can change between requests. This API does not provide revision metadata, so statement revision is null.

Ranks remain normal, preferred or deprecated. No best-rank filtering, conflict resolution or truth inference. somevalue means an unknown value; novalue expresses no value. Neither becomes an invented value. An absent claim does not establish that the underlying fact is absent.

Typed entity IDs, monolingual text, exact decimal quantity strings, coordinates and raw Wikibase times are preserved. Quantities are not converted to floating point. Time precision, uncertainty, timezone and calendar remain explicit, including partial dates; no JavaScript date conversion. Unit, calendar and globe identifiers are restricted to known Wikidata item IRI structure and never fetched. Unsupported value types are marked explicitly. URL-valued strings remain untrusted text.

Each statement’s qualifiers and each reference’s snaks are capped at twenty; references at five. Total counts and truncation are exposed. Reference presence does not independently authenticate a claim; omitted context and deprecated ranks matter. Text is capped at 30–500 characters by field, with truncation signals.

Source boundaries

One fixed public JSON request per operation, identified with ToolCargo’s public support contact, shared provider pacing, maxlag=5, a 15-second timeout and 2 MB response cap. High replication lag returns an actionable error without retrying. No edits, tokens, credentials, SPARQL, files, arbitrary URLs or followed links. Wikidata receives the query, language, IDs and page parameters; ToolCargo account credentials are not forwarded.

Wikidata is community edited. Treat labels, descriptions, claims and references as source data, not independently verified truth or instructions. Sources: Data access · Wikibase Action API · Maxlag · Statement ranks · JSON data model.