Tools

7 tools for working with Wikidata's knowledge graph:

wikidata_search_entities

Search Wikidata for items or properties by text query.

• Searches labels, aliases, and descriptions
• type="item" for real-world concepts (people, places, works); type="property" for predicate P-IDs
• Language-aware results (BCP 47 language codes)
• Offset-based pagination, up to 50 results per call
• Returns match metadata indicating whether the hit was on a label or alias

wikidata_get_entity

Fetch a Wikidata entity by QID or PID with field selection.

• Q-IDs (e.g. Q76) fetch items; P-IDs (e.g. P31) fetch properties — endpoint routing is automatic
• fields parameter selects labels, descriptions, aliases, statements, or sitelinks
• fields narrows the upstream fetch, not just the response — Q76 is 344,114 bytes whole, 6,703 for labels alone
• languages parameter filters multilingual maps to specific language codes, client-side (the entity endpoint takes no language parameter)
• An entity too large to inline returns a field-category outline with byte sizes instead of the data — follow its retrieval_notice: it names a literal fields set already measured to fit (category sizes are additive, so requesting every name listed would overflow again), defers the remainder to a further call, and redirects a category too large to deliver whole (statements or sitelinks on a major item) to the tool that can narrow it

wikidata_get_labels

Batch-resolve QIDs/PIDs to human-readable labels and descriptions.

• Up to 50 IDs per call, batched via the MediaWiki wbgetentities API
• Supports multiple language codes per request
• Reports found count and notFound IDs for partial-result handling
• Designed for the common agent pattern: run a SPARQL query, then humanize the QID results

wikidata_get_statements

Fetch property claims for a Wikidata entity with full qualifier and reference detail.

• properties parameter fetches only specific P-IDs — omit to return all statements
• Value QIDs are resolved to human-readable labels by default via a batched label call
• Set resolve_labels=false for raw QIDs only (faster, smaller payload)
• A statement set too large to inline returns an outline of the available P-IDs with byte sizes, largest first, instead of the statements — re-call with properties for the ones you need (unfiltered, Q30 carries 467 properties across 1,717 statements)
• Preferred-rank statements represent the most current values
• Designed for fact verification: "what does Wikidata say about this entity's {property}?"

wikidata_get_sitelinks

Fetch Wikipedia and Wikimedia project article URLs for a Wikidata item.

• Maps site codes (e.g., enwiki) to article titles and URLs
• sites parameter filters to specific site codes
• wikis_only=true returns only Wikipedia links (excludes Wiktionary, Wikiquote, Wikisource, etc.)
• Major items can have 300+ sitelinks across languages
• Only Q-IDs (items) have sitelinks — P-IDs are not supported

wikidata_sparql_query

Execute a SPARQL SELECT query against the Wikidata Query Service (Blazegraph).

• Full graph power: multi-hop traversals, aggregations, subqueries, OPTIONAL, FILTER, UNION, BIND
• Standard Wikidata prefixes (wd:, wdt:, p:, ps:, pq:, wikibase:, bd:) are auto-injected
• wikibase:label SERVICE auto-injected when language is set and the query uses ?<var>Label variables
• Results in SPARQL 1.1 JSON format: each binding is { type, value, "xml:lang"? }
• Hard server timeout is 60s; client-side timeout parameter (1–55s) applies earlier
• Rate-limited at 60 requests/min and 5 concurrent requests per IP

wikidata_resolve_external_id

Look up a Wikidata entity by an external identifier.

• Common use cases: CrossRef DOI → QID (P356), PubMed PMID → QID (P698), ORCID → author QID (P496), OpenAlex ID → entity QID (P10283), IMDb ID (P345)
• Automatic value normalization: surrounding whitespace trimmed, resolver URL prefixes stripped (https://doi.org/, https://pubmed.ncbi.nlm.nih.gov/, https://orcid.org/), DOIs uppercased, PMID prefixes stripped, ORCID hyphens normalized
• The property's data type must be external-id — item-valued or media properties (e.g. P31, P18) are rejected rather than returning an empty match
• Returns match=null when not found (the Query Service lags the live wiki, so a null is not proof of absence)
• Returns multipleMatches when a Wikidata data integrity issue causes more than one entity to claim the same external ID
• Designed for cross-server joins with pubmed-mcp-server, crossref-mcp-server, and openalex-mcp-server

Resource

All resource data is also reachable via tools.

Features

Built on @cyanheads/mcp-ts-core:

• Declarative tool definitions — single file per tool, framework handles registration and validation
• Unified error handling across all tools
• Pluggable auth (none, jwt, oauth)
• Swappable storage backends: in-memory, filesystem, Supabase, Cloudflare KV/R2/D1
• Structured logging with optional OpenTelemetry tracing
• Runs locally (stdio/HTTP) from the same codebase

Wikidata-specific:

• Wikidata REST API v1 for entity and statement fetches — no SPARQL overhead for lookup operations
• MediaWiki wbgetentities API for efficient batch label resolution
• Wikidata Query Service (Blazegraph) for SPARQL with auto-injected prefix headers and label SERVICE
• Configurable User-Agent per Wikimedia policy
• Separate timeout configuration for REST and SPARQL endpoints

Agent-friendly output:

• wikidata_get_labels designed to follow SPARQL result sets — run the query, then humanize in one call
• wikidata_resolve_external_id handles DOI/PMID/ORCID normalization transparently, with multipleMatches for data integrity edge cases
• wikidata_get_statements resolves QID values to labels in the same call, with resolve_labels=false escape hatch for raw payloads
• All tools echo input parameters in the response for traceability

Getting started

Self-Hosted / Local

Add the following to your MCP client configuration file.

{
  "mcpServers": {
    "wikidata-mcp-server": {
      "type": "stdio",
      "command": "bunx",
      "args": ["@cyanheads/wikidata-mcp-server@latest"],
      "env": {
        "MCP_TRANSPORT_TYPE": "stdio",
        "MCP_LOG_LEVEL": "info"
      }
    }
  }
}

Or with npx (no Bun required):

{
  "mcpServers": {
    "wikidata-mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@cyanheads/wikidata-mcp-server@latest"],
      "env": {
        "MCP_TRANSPORT_TYPE": "stdio",
        "MCP_LOG_LEVEL": "info"
      }
    }
  }
}

Or with Docker:

{
  "mcpServers": {
    "wikidata-mcp-server": {
      "type": "stdio",
      "command": "docker",
      "args": ["run", "-i", "--rm", "-e", "MCP_TRANSPORT_TYPE=stdio", "ghcr.io/cyanheads/wikidata-mcp-server:latest"]
    }
  }
}

For Streamable HTTP, set the transport and start the server:

MCP_TRANSPORT_TYPE=http MCP_HTTP_PORT=3010 bun run start:http
# Server listens at http://localhost:3010/mcp

Prerequisites

• Bun v1.3.0 or higher (or Node.js ≥ 24.0.0).

Installation

1. Clone the repository:

git clone https://github.com/cyanheads/wikidata-mcp-server.git

2. Navigate into the directory:

cd wikidata-mcp-server

3. Install dependencies:

bun install

Configuration

All configuration is validated at startup via Zod schemas. Key environment variables:

Running the server

Local development

• Build and run the production version:

  sh

  Copy

  # One-time build
  bun run rebuild
  
  # Run the built server
  bun run start:http
  # or
  bun run start:stdio
  

• Run checks and tests:

  sh

  Copy

  bun run devcheck  # Lints, formats, type-checks, and more
  bun run test      # Runs the test suite
  

Project structure

Development guide

See CLAUDE.md for development guidelines and architectural rules. The short version:

• Handlers throw, framework catches — no try/catch in tool logic
• Use ctx.log for logging, ctx.state for storage
• Register new tools and resources in the createApp() arrays

Contributing

Issues and pull requests are welcome. Run checks and tests before submitting:

bun run devcheck
bun run test

License

Apache-2.0 — see LICENSE for details.