@cyanheads/wikidata-mcp-server 0.1.1

package/dist/mcp-server/tools/definitions/get-labels.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-labels.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-labels.tool.ts"],"names":[],"mappings":"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"}

package/dist/mcp-server/tools/definitions/get-sitelinks.tool.d.ts

@@ -0,0 +1,31 @@
+/**
+ * @fileoverview Fetch Wikimedia sitelinks for a Wikidata entity.
+ * @module mcp-server/tools/definitions/get-sitelinks.tool
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+export declare const wikidataGetSitelinks: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    id: z.ZodString;
+    sites: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    wikis_only: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>, z.ZodObject<{
+    id: z.ZodString;
+    sitelinks: z.ZodRecord<z.ZodString, z.ZodObject<{
+        title: z.ZodString;
+        url: z.ZodOptional<z.ZodString>;
+        badges: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>;
+    count: z.ZodNumber;
+    message: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, readonly [{
+    readonly reason: "entity_not_found";
+    readonly code: JsonRpcErrorCode.NotFound;
+    readonly when: "No item exists at this Q-ID.";
+    readonly recovery: "Verify the Q-ID with wikidata_search_entities or wikidata_get_labels.";
+}, {
+    readonly reason: "not_an_item";
+    readonly code: JsonRpcErrorCode.InvalidParams;
+    readonly when: "A P-ID was supplied — only items (Q-IDs) have sitelinks.";
+    readonly recovery: "Supply a Q-ID (Q followed by digits). Properties do not have Wikipedia sitelinks.";
+}]>;
+//# sourceMappingURL=get-sitelinks.tool.d.ts.map

package/dist/mcp-server/tools/definitions/get-sitelinks.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-sitelinks.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-sitelinks.tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAOjE,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;GAiK/B,CAAC"}

package/dist/mcp-server/tools/definitions/get-sitelinks.tool.js

@@ -0,0 +1,128 @@
+/**
+ * @fileoverview Fetch Wikimedia sitelinks for a Wikidata entity.
+ * @module mcp-server/tools/definitions/get-sitelinks.tool
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+import { getWikidataRestService, isQId, normalizeId, } from '../../../services/wikidata/wikidata-rest-service.js';
+export const wikidataGetSitelinks = tool('wikidata_get_sitelinks', {
+    title: 'Get Wikidata Sitelinks',
+    description: 'Fetch Wikipedia and Wikimedia project article URLs for a Wikidata item. ' +
+        'A sitelink maps a site code (e.g., "enwiki") to a Wikipedia article title and URL. ' +
+        'Major items can have 300+ sitelinks across languages. ' +
+        'Use sites to filter to specific language editions, or wikis_only to return only Wikipedia links. ' +
+        'Only Q-IDs (items) have sitelinks — properties (P-IDs) do not.',
+    annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: true },
+    input: z.object({
+        id: z
+            .string()
+            .min(1)
+            .describe('Q-ID of the item (e.g., "Q76"). Only items have sitelinks; properties (P-IDs) are not supported.'),
+        sites: z
+            .array(z.string().min(1))
+            .optional()
+            .describe('Optional filter to specific site codes (e.g., ["enwiki", "frwiki", "dewiki"]). ' +
+            'Omit to return all sitelinks.'),
+        wikis_only: z
+            .boolean()
+            .default(false)
+            .describe('When true, return only Wikipedia sitelinks (site codes ending in "wiki", e.g., "enwiki", "dewiki"). ' +
+            'Excludes Wikisource, Wiktionary, Wikiquote, etc.'),
+    }),
+    output: z.object({
+        id: z.string().describe('The Q-ID whose sitelinks were fetched.'),
+        sitelinks: z
+            .record(z.string(), z.object({
+            title: z.string().describe('Article title on that wiki.'),
+            url: z.string().optional().describe('Full URL to the article. Omitted when unavailable.'),
+            badges: z
+                .array(z.string())
+                .optional()
+                .describe('Quality badge QIDs (e.g., "Q17437798" = featured article).'),
+        }))
+            .describe('Map of site code to sitelink metadata. Empty when the entity has no matching sitelinks.'),
+        count: z.number().describe('Number of sitelinks returned.'),
+        message: z
+            .string()
+            .optional()
+            .describe('Informational note when no sitelinks were found. Absent when sitelinks are present.'),
+    }),
+    errors: [
+        {
+            reason: 'entity_not_found',
+            code: JsonRpcErrorCode.NotFound,
+            when: 'No item exists at this Q-ID.',
+            recovery: 'Verify the Q-ID with wikidata_search_entities or wikidata_get_labels.',
+        },
+        {
+            reason: 'not_an_item',
+            code: JsonRpcErrorCode.InvalidParams,
+            when: 'A P-ID was supplied — only items (Q-IDs) have sitelinks.',
+            recovery: 'Supply a Q-ID (Q followed by digits). Properties do not have Wikipedia sitelinks.',
+        },
+    ],
+    async handler(input, ctx) {
+        const id = normalizeId(input.id);
+        if (!isQId(id)) {
+            throw ctx.fail('not_an_item', `"${input.id}" is not a Q-ID. Only Wikidata items have sitelinks.`, { ...ctx.recoveryFor('not_an_item') });
+        }
+        const svc = getWikidataRestService();
+        ctx.log.info('Fetching sitelinks', { id, sites: input.sites, wikis_only: input.wikis_only });
+        let rawSitelinks;
+        try {
+            rawSitelinks = await svc.fetchSitelinks(id, input.sites, ctx);
+        }
+        catch (err) {
+            if (err?.data?.status === 404) {
+                throw ctx.fail('entity_not_found', `No item found for Q-ID "${id}".`, {
+                    ...ctx.recoveryFor('entity_not_found'),
+                });
+            }
+            throw err;
+        }
+        // Apply wikis_only filter
+        let sitelinks = rawSitelinks;
+        if (input.wikis_only) {
+            sitelinks = Object.fromEntries(Object.entries(rawSitelinks).filter(([code]) => code.endsWith('wiki')));
+        }
+        const normalized = Object.fromEntries(Object.entries(sitelinks).map(([code, sl]) => [
+            code,
+            {
+                title: sl.title,
+                ...(sl.url ? { url: sl.url } : {}),
+                ...(sl.badges?.length ? { badges: sl.badges } : {}),
+            },
+        ]));
+        const count = Object.keys(normalized).length;
+        if (count === 0) {
+            const hint = input.sites?.length
+                ? `None of the requested site codes (${input.sites.join(', ')}) were found on ${id}.`
+                : input.wikis_only
+                    ? `${id} has no Wikipedia (wikis_only) sitelinks.`
+                    : `${id} has no sitelinks.`;
+            return { id, sitelinks: {}, count: 0, message: hint };
+        }
+        return { id, sitelinks: normalized, count };
+    },
+    format: (result) => {
+        const lines = [`## Sitelinks for ${result.id}`, `**Count:** ${result.count}`];
+        if (result.message) {
+            lines.push(`\n> ${result.message}`);
+        }
+        // Sort: Wikipedia editions first, then others
+        const entries = Object.entries(result.sitelinks);
+        const wikis = entries.filter(([code]) => code.endsWith('wiki'));
+        const others = entries.filter(([code]) => !code.endsWith('wiki'));
+        const sorted = [...wikis, ...others];
+        for (const [code, sl] of sorted.slice(0, 30)) {
+            const url = sl.url ??
+                `https://${code.replace('wiki', '')}.wikipedia.org/wiki/${encodeURIComponent(sl.title)}`;
+            lines.push(`**${code}:** [${sl.title}](${url})${sl.badges?.length ? ` [${sl.badges.join(', ')}]` : ''}`);
+        }
+        if (sorted.length > 30) {
+            lines.push(`… and ${sorted.length - 30} more sitelinks.`);
+        }
+        return [{ type: 'text', text: lines.join('\n') }];
+    },
+});
+//# sourceMappingURL=get-sitelinks.tool.js.map

package/dist/mcp-server/tools/definitions/get-sitelinks.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-sitelinks.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-sitelinks.tool.ts"],"names":[],"mappings":"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"}

package/dist/mcp-server/tools/definitions/get-statements.tool.d.ts

@@ -0,0 +1,29 @@
+/**
+ * @fileoverview Fetch and normalize property statements for a Wikidata entity with label resolution.
+ * @module mcp-server/tools/definitions/get-statements.tool
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+export declare const wikidataGetStatements: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    id: z.ZodString;
+    properties: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    language: z.ZodDefault<z.ZodString>;
+    resolve_labels: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>, z.ZodObject<{
+    id: z.ZodString;
+    statements: z.ZodRecord<z.ZodString, z.ZodArray<z.ZodObject<{}, z.core.$loose>>>;
+    propertyCount: z.ZodNumber;
+    statementCount: z.ZodNumber;
+    labelsResolved: z.ZodBoolean;
+}, z.core.$strip>, readonly [{
+    readonly reason: "entity_not_found";
+    readonly code: JsonRpcErrorCode.NotFound;
+    readonly when: "No entity exists at this QID.";
+    readonly recovery: "Verify the ID with wikidata_search_entities or wikidata_get_labels.";
+}, {
+    readonly reason: "invalid_id";
+    readonly code: JsonRpcErrorCode.InvalidParams;
+    readonly when: "ID is not a valid Q-ID or P-ID format.";
+    readonly recovery: "Supply a valid Q-ID (Q followed by digits) or P-ID (P followed by digits).";
+}]>;
+//# sourceMappingURL=get-statements.tool.d.ts.map

package/dist/mcp-server/tools/definitions/get-statements.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-statements.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-statements.tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAUjE,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;GA2KhC,CAAC"}

package/dist/mcp-server/tools/definitions/get-statements.tool.js

@@ -0,0 +1,185 @@
+/**
+ * @fileoverview Fetch and normalize property statements for a Wikidata entity with label resolution.
+ * @module mcp-server/tools/definitions/get-statements.tool
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+import { getWikidataRestService, isPId, isQId, normalizeId, normalizeStatements, } from '../../../services/wikidata/wikidata-rest-service.js';
+export const wikidataGetStatements = tool('wikidata_get_statements', {
+    title: 'Get Wikidata Statements',
+    description: 'Fetch property claims for a Wikidata entity with qualifier and reference detail. ' +
+        'Value QIDs are resolved to human-readable labels by default. ' +
+        'Use the properties parameter to fetch only specific P-IDs — omitting it returns all statements, ' +
+        'which can be large. Designed for fact verification: "what does Wikidata say about this entity\'s {property}?". ' +
+        'Preferred-rank statements are the most current values.',
+    annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: true },
+    input: z.object({
+        id: z
+            .string()
+            .min(1)
+            .describe('Q-ID (e.g., "Q76") or P-ID of the entity to fetch statements for.'),
+        properties: z
+            .array(z.string().min(1))
+            .optional()
+            .describe('P-IDs to fetch (e.g., ["P31", "P569", "P27"]). Omit to return all properties (may be large for major items).'),
+        language: z
+            .string()
+            .default('en')
+            .describe('Language code for label resolution of QID values (e.g., "en", "de").'),
+        resolve_labels: z
+            .boolean()
+            .default(true)
+            .describe('Resolve wikibase-item value QIDs to human-readable labels via a batched label call. ' +
+            'Set to false to skip label resolution and return raw QIDs only (faster, smaller payload).'),
+    }),
+    output: z.object({
+        id: z.string().describe('The entity ID whose statements were fetched.'),
+        // Statement values are from a dynamic external API (12+ data types, each with a different shape).
+        // Passthrough preserves all normalized fields in structuredContent without over-typing each branch.
+        statements: z
+            .record(z.string(), z.array(z.object({}).passthrough()))
+            .describe('Map of property ID to array of normalized statements. ' +
+            'Each statement has id, rank, property, value (with type-specific fields), ' +
+            'and optional qualifiers and references arrays.'),
+        propertyCount: z.number().describe('Number of distinct properties returned.'),
+        statementCount: z.number().describe('Total number of statement objects across all properties.'),
+        labelsResolved: z
+            .boolean()
+            .describe('True when QID values were resolved to labels. False when resolve_labels was set to false.'),
+    }),
+    errors: [
+        {
+            reason: 'entity_not_found',
+            code: JsonRpcErrorCode.NotFound,
+            when: 'No entity exists at this QID.',
+            recovery: 'Verify the ID with wikidata_search_entities or wikidata_get_labels.',
+        },
+        {
+            reason: 'invalid_id',
+            code: JsonRpcErrorCode.InvalidParams,
+            when: 'ID is not a valid Q-ID or P-ID format.',
+            recovery: 'Supply a valid Q-ID (Q followed by digits) or P-ID (P followed by digits).',
+        },
+    ],
+    async handler(input, ctx) {
+        const id = normalizeId(input.id);
+        if (!isQId(id) && !isPId(id)) {
+            throw ctx.fail('invalid_id', `"${input.id}" is not a valid Wikidata ID.`, {
+                ...ctx.recoveryFor('invalid_id'),
+            });
+        }
+        const svc = getWikidataRestService();
+        ctx.log.info('Fetching statements', {
+            id,
+            properties: input.properties,
+            language: input.language,
+            resolve_labels: input.resolve_labels,
+        });
+        let rawStatements;
+        try {
+            rawStatements = await svc.fetchStatements(id, input.properties, ctx);
+        }
+        catch (err) {
+            if (err?.data?.status === 404) {
+                throw ctx.fail('entity_not_found', `No entity found for ID "${id}".`, {
+                    ...ctx.recoveryFor('entity_not_found'),
+                });
+            }
+            throw err;
+        }
+        // Collect all value QIDs for label resolution
+        const labelMap = {};
+        if (input.resolve_labels) {
+            const qidsToResolve = new Set();
+            for (const stmts of Object.values(rawStatements)) {
+                for (const stmt of stmts) {
+                    if (stmt.property?.data_type === 'wikibase-item') {
+                        const content = stmt.value?.content;
+                        if (content?.id)
+                            qidsToResolve.add(content.id);
+                    }
+                    // Also check qualifier values
+                    for (const q of stmt.qualifiers ?? []) {
+                        if (q.property?.data_type === 'wikibase-item') {
+                            const qContent = q.value?.content;
+                            if (qContent?.id)
+                                qidsToResolve.add(qContent.id);
+                        }
+                    }
+                }
+            }
+            if (qidsToResolve.size > 0) {
+                const labelData = await svc.fetchLabels([...qidsToResolve], [input.language], ctx);
+                for (const [qid, data] of Object.entries(labelData)) {
+                    const label = data.labels[input.language];
+                    if (label)
+                        labelMap[qid] = label;
+                }
+            }
+        }
+        // Normalize statements
+        const normalized = {};
+        for (const [propertyId, stmts] of Object.entries(rawStatements)) {
+            normalized[propertyId] = normalizeStatements(propertyId, stmts, labelMap);
+        }
+        const statementCount = Object.values(normalized).reduce((acc, stmts) => acc + stmts.length, 0);
+        return {
+            id,
+            statements: normalized,
+            propertyCount: Object.keys(normalized).length,
+            statementCount,
+            labelsResolved: input.resolve_labels,
+        };
+    },
+    format: (result) => {
+        const lines = [
+            `## Statements for ${result.id}`,
+            `**Properties:** ${result.propertyCount} | **Total statements:** ${result.statementCount} | **Labels resolved:** ${result.labelsResolved}`,
+        ];
+        for (const [propId, rawStmts] of Object.entries(result.statements)) {
+            lines.push('');
+            lines.push(`### ${propId}`);
+            for (const rawStmt of rawStmts) {
+                const stmt = rawStmt;
+                if (!stmt?.value)
+                    continue;
+                const rankIndicator = stmt.rank === 'preferred' ? ' ★' : stmt.rank === 'deprecated' ? ' ~~(deprecated)~~' : '';
+                const valueStr = formatStatementValue(stmt.value);
+                lines.push(`- ${valueStr}${rankIndicator}`);
+                if (stmt.qualifiers?.length) {
+                    for (const q of stmt.qualifiers) {
+                        if (!q?.value)
+                            continue;
+                        lines.push(`  - ${q.property}: ${formatStatementValue(q.value)}`);
+                    }
+                }
+            }
+        }
+        return [{ type: 'text', text: lines.join('\n') }];
+    },
+});
+function formatStatementValue(value) {
+    switch (value.type) {
+        case 'wikibase-item':
+            return value.label ? `${value.label} (${value.qid})` : value.qid;
+        case 'time':
+            return value.time;
+        case 'quantity':
+            return value.unitLabel
+                ? `${value.amount} ${value.unitLabel}`
+                : value.unit && value.unit !== '1'
+                    ? `${value.amount} (${value.unit})`
+                    : value.amount;
+        case 'string':
+            return value.value;
+        case 'monolingualtext':
+            return `${value.text} [${value.language}]`;
+        case 'globe-coordinate':
+            return `${value.latitude}, ${value.longitude}`;
+        case 'other':
+            return JSON.stringify(value.raw ?? '');
+        default:
+            return '(unknown)';
+    }
+}
+//# sourceMappingURL=get-statements.tool.js.map

package/dist/mcp-server/tools/definitions/get-statements.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-statements.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-statements.tool.ts"],"names":[],"mappings":"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"}

package/dist/mcp-server/tools/definitions/resolve-external-id.tool.d.ts

@@ -0,0 +1,30 @@
+/**
+ * @fileoverview Look up a Wikidata entity by an external identifier (DOI, PubMed ID, ORCID, etc.).
+ * @module mcp-server/tools/definitions/resolve-external-id.tool
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+export declare const wikidataResolveExternalId: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    property: z.ZodString;
+    value: z.ZodString;
+    language: z.ZodDefault<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    match: z.ZodNullable<z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodString;
+        description: z.ZodString;
+        url: z.ZodString;
+    }, z.core.$strip>>;
+    property: z.ZodString;
+    value: z.ZodString;
+    multipleMatches: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodString;
+    }, z.core.$strip>>>;
+}, z.core.$strip>, readonly [{
+    readonly reason: "invalid_property";
+    readonly code: JsonRpcErrorCode.InvalidParams;
+    readonly when: "Property ID is not in P+digits format.";
+    readonly recovery: "Supply a valid P-ID (P followed by digits, e.g. P356 for DOI).";
+}]>;
+//# sourceMappingURL=resolve-external-id.tool.d.ts.map

package/dist/mcp-server/tools/definitions/resolve-external-id.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-external-id.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/resolve-external-id.tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AA0BjE,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;GAqMpC,CAAC"}

package/dist/mcp-server/tools/definitions/resolve-external-id.tool.js

@@ -0,0 +1,193 @@
+/**
+ * @fileoverview Look up a Wikidata entity by an external identifier (DOI, PubMed ID, ORCID, etc.).
+ * @module mcp-server/tools/definitions/resolve-external-id.tool
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+import { getWikidataSparqlService } from '../../../services/wikidata/wikidata-sparql-service.js';
+/** Normalize a value to the canonical form Wikidata stores it in for known P-IDs. */
+function normalizeExternalId(property, value) {
+    const upperProp = property.toUpperCase();
+    switch (upperProp) {
+        case 'P356':
+            // DOI: stored uppercase
+            return value.toUpperCase();
+        case 'P698':
+            // PubMed ID: strip "PMID:" prefix, keep numeric
+            return value.replace(/^PMID[:\s]*/i, '').trim();
+        case 'P496': {
+            // ORCID: normalize to 0000-0000-0000-000X format
+            const stripped = value.replace(/[-\s]/g, '');
+            if (stripped.length === 16) {
+                return `${stripped.slice(0, 4)}-${stripped.slice(4, 8)}-${stripped.slice(8, 12)}-${stripped.slice(12)}`;
+            }
+            return value;
+        }
+        default:
+            return value;
+    }
+}
+export const wikidataResolveExternalId = tool('wikidata_resolve_external_id', {
+    title: 'Resolve Wikidata External ID',
+    description: 'Look up a Wikidata entity by an external identifier such as a DOI, PubMed ID, ORCID iD, or OpenAlex ID. ' +
+        'Returns match=<entity> on success, match=null when not found, and match=null with multipleMatches populated ' +
+        'when a Wikidata data integrity issue causes more than one entity to claim the same external ID. ' +
+        'Common cross-server join use cases: CrossRef DOI → Wikidata paper QID (P356), ' +
+        'PubMed PMID → Wikidata paper QID (P698), ORCID → author QID (P496), ' +
+        'OpenAlex ID → entity QID (P10283). ' +
+        'Known value normalization is applied automatically: DOIs are uppercased, PMID prefixes stripped, ORCID hyphens normalized.',
+    annotations: { readOnlyHint: true, openWorldHint: true },
+    input: z.object({
+        property: z
+            .string()
+            .min(1)
+            .describe('P-ID of the external identifier property (e.g., "P356" for DOI, "P698" for PubMed ID, ' +
+            '"P496" for ORCID, "P10283" for OpenAlex ID, "P345" for IMDb ID).'),
+        value: z
+            .string()
+            .min(1)
+            .describe('The external identifier value to look up (e.g., "10.1038/nature01234" for a DOI, ' +
+            '"32283226" for a PubMed ID, "0000-0002-1825-0097" for an ORCID).'),
+        language: z
+            .string()
+            .default('en')
+            .describe('Language code for label and description in the response (e.g., "en", "de").'),
+    }),
+    output: z.object({
+        match: z
+            .object({
+            id: z.string().describe('Wikidata Q-ID of the matching entity (e.g., "Q12345").'),
+            label: z
+                .string()
+                .describe('Display label in the requested language, or empty string if unavailable.'),
+            description: z
+                .string()
+                .describe('Short description in the requested language, or empty string if unavailable.'),
+            url: z
+                .string()
+                .describe('Wikidata entity page URL (e.g., "https://www.wikidata.org/wiki/Q12345").'),
+        })
+            .nullable()
+            .describe('Matching entity, or null when no Wikidata entity claims this external identifier ' +
+            '(including the case where multipleMatches is populated).'),
+        property: z.string().describe('The P-ID used for the lookup.'),
+        value: z
+            .string()
+            .describe('The normalized value that was searched (may differ from input due to canonicalization).'),
+        multipleMatches: z
+            .array(z
+            .object({
+            id: z.string().describe('Q-ID of a matching entity.'),
+            label: z.string().describe('Display label of this match.'),
+        })
+            .describe('One of the entities that claims this external identifier.'))
+            .optional()
+            .describe('Present when more than one Wikidata entity claims this external ID (data integrity issue). ' +
+            'match is null when this field is present. Inspect the list and select the correct QID manually.'),
+    }),
+    errors: [
+        {
+            reason: 'invalid_property',
+            code: JsonRpcErrorCode.InvalidParams,
+            when: 'Property ID is not in P+digits format.',
+            recovery: 'Supply a valid P-ID (P followed by digits, e.g. P356 for DOI).',
+        },
+    ],
+    async handler(input, ctx) {
+        const prop = input.property.toUpperCase();
+        if (!/^P\d+$/.test(prop)) {
+            throw ctx.fail('invalid_property', `"${input.property}" is not a valid property ID. Expected P followed by digits.`, { ...ctx.recoveryFor('invalid_property') });
+        }
+        const normalizedValue = normalizeExternalId(prop, input.value);
+        ctx.log.info('Resolving external ID', {
+            property: prop,
+            value: normalizedValue,
+            language: input.language,
+        });
+        const svc = getWikidataSparqlService();
+        // Escape value for SPARQL string literal — double quotes need escaping
+        const escapedValue = normalizedValue.replace(/\\/g, '\\\\').replace(/"/g, '\\"');
+        const sparql = `SELECT ?item ?itemLabel ?itemDescription WHERE {
+  ?item wdt:${prop} "${escapedValue}" .
+  OPTIONAL { ?item rdfs:label ?itemLabel . FILTER(LANG(?itemLabel) = "${input.language}") }
+  OPTIONAL { ?item schema:description ?itemDescription . FILTER(LANG(?itemDescription) = "${input.language}") }
+}
+LIMIT 5`;
+        const response = await svc.query(sparql, '', undefined, ctx);
+        const bindings = response.results.bindings;
+        if (bindings.length === 0) {
+            return { match: null, property: prop, value: normalizedValue };
+        }
+        // Extract QIDs
+        const matches = bindings.map((b) => ({
+            id: b.item?.value.replace('http://www.wikidata.org/entity/', '') ?? '',
+            label: b.itemLabel?.value ?? '',
+            description: b.itemDescription?.value ?? '',
+        }));
+        // Deduplicate by QID (SPARQL may return multiple rows for same item with different labels)
+        const seen = new Set();
+        const unique = matches.filter((m) => {
+            if (seen.has(m.id))
+                return false;
+            seen.add(m.id);
+            return true;
+        });
+        if (unique.length > 1) {
+            // Wikidata data integrity issue — multiple entities claim the same external ID.
+            // Return all matches so the agent can pick the right one.
+            return {
+                match: null,
+                property: prop,
+                value: normalizedValue,
+                multipleMatches: unique.map((m) => ({ id: m.id, label: m.label })),
+            };
+        }
+        // unique.length === 1 guaranteed by the preceding check
+        const m = unique[0];
+        return {
+            match: {
+                id: m.id,
+                label: m.label,
+                description: m.description,
+                url: `https://www.wikidata.org/wiki/${m.id}`,
+            },
+            property: prop,
+            value: normalizedValue,
+        };
+    },
+    format: (result) => {
+        const lines = [
+            `**Property:** ${result.property} | **Value searched:** ${result.value}`,
+        ];
+        if (result.match !== null) {
+            lines.push(`**Match:** ${result.match.label || result.match.id}`);
+            lines.push('');
+            lines.push(`## ${result.match.label || result.match.id}`);
+            lines.push(`**QID:** ${result.match.id}`);
+            if (result.match.description)
+                lines.push(`**Description:** ${result.match.description}`);
+            lines.push(`**URL:** ${result.match.url}`);
+        }
+        else if (result.multipleMatches?.length) {
+            lines.push(`**Match:** multiple (${result.multipleMatches.length}) — Wikidata data integrity issue`);
+            lines.push('\n**Multiple entities claim this external ID — select the correct QID manually:**');
+            for (const entry of result.multipleMatches) {
+                lines.push(`- ${entry.id}: ${entry.label || '(no label)'}`);
+            }
+        }
+        else {
+            lines.push('**Match:** none');
+            lines.push('\n> No Wikidata entity found for this external identifier.');
+        }
+        // Render multipleMatches even when match is present — satisfies format parity for linter
+        // synthetic variants that populate both fields simultaneously.
+        if (result.match !== null && result.multipleMatches?.length) {
+            lines.push('\n**Also matched:**');
+            for (const entry of result.multipleMatches) {
+                lines.push(`- ${entry.id}: ${entry.label || '(no label)'}`);
+            }
+        }
+        return [{ type: 'text', text: lines.join('\n') }];
+    },
+});
+//# sourceMappingURL=resolve-external-id.tool.js.map