@cyanheads/orcid-mcp-server 0.1.1

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

@@ -0,0 +1,146 @@
+/**
+ * @fileoverview Fetch peer review activity records for an ORCID researcher:
+ * convening organizations, reviewer roles, review types, and ISSN-keyed groups.
+ * @module mcp-server/tools/definitions/get-peer-reviews.tool
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode, McpError } from '@cyanheads/mcp-ts-core/errors';
+import { getOrcidService, normalizeOrcidId } from '../../../services/orcid/orcid-service.js';
+export const orcidGetPeerReviews = tool('orcid_get_peer_reviews', {
+    title: 'Get ORCID Researcher Peer Reviews',
+    description: "Fetch peer review activity for an ORCID researcher: convening organizations (journals and publishers), reviewer role (reviewer, editor, chair, etc.), review type, completion dates, and ISSN-keyed group identifiers. Use to assess editorial activity, journal affiliations, and the scope of a researcher's peer review contributions. Peer review records are self-reported or imported by participating publishers — coverage varies by researcher.",
+    annotations: { readOnlyHint: true, openWorldHint: false, idempotentHint: true },
+    input: z.object({
+        orcid_id: z
+            .string()
+            .regex(/^(https?:\/\/orcid\.org\/)?\d{4}-\d{4}-\d{4}-\d{3}[\dX]$/, 'Must be a valid ORCID iD (e.g. 0000-0001-2345-6789) or full ORCID URI.')
+            .describe('ORCID iD — bare format (0000-0001-2345-6789) or full URI (https://orcid.org/0000-0001-2345-6789).'),
+    }),
+    output: z.object({
+        orcidId: z.string().describe('Normalized ORCID iD (bare format).'),
+        orcidUri: z.string().describe('Full ORCID URI.'),
+        reviewCount: z.number().describe('Total number of peer review records returned.'),
+        peerReviews: z
+            .array(z
+            .object({
+            reviewerRole: z
+                .string()
+                .optional()
+                .describe('Reviewer role (e.g. reviewer, editor, chair, organizer, co-investigator, co-reviewer).'),
+            reviewType: z
+                .string()
+                .optional()
+                .describe('Review type (e.g. review, evaluation, grant-review, editor-report).'),
+            completionDate: z
+                .string()
+                .optional()
+                .describe('Completion date of the review (YYYY, YYYY-MM, or YYYY-MM-DD).'),
+            conveningOrganization: z
+                .object({
+                name: z
+                    .string()
+                    .optional()
+                    .describe('Convening organization name (journal or publisher).'),
+                city: z.string().optional().describe('Convening organization city.'),
+                country: z.string().optional().describe('Convening organization country.'),
+                disambiguatedId: z
+                    .string()
+                    .optional()
+                    .describe('Disambiguated organization identifier.'),
+                disambiguationSource: z
+                    .string()
+                    .optional()
+                    .describe('Source of disambiguation (ROR, GRID, RINGGOLD, etc.).'),
+            })
+                .optional()
+                .describe('Journal or publisher that convened the review.'),
+            reviewUrl: z.string().optional().describe('URL for the review record, if available.'),
+            groupIssn: z
+                .string()
+                .optional()
+                .describe('ISSN of the journal group this review belongs to, if available.'),
+        })
+            .describe('Peer review record.'))
+            .describe('Peer review records for this ORCID iD.'),
+        notice: z
+            .string()
+            .optional()
+            .describe('Note when no peer reviews are found — coverage varies by researcher and publisher participation.'),
+    }),
+    errors: [
+        {
+            reason: 'profile_not_found',
+            code: JsonRpcErrorCode.NotFound,
+            when: 'The ORCID iD does not correspond to a registered researcher.',
+            recovery: 'Verify the ORCID iD is correct and try orcid_search_researchers to find valid iDs.',
+        },
+    ],
+    async handler(input, ctx) {
+        const service = getOrcidService();
+        ctx.log.info('orcid_get_peer_reviews', { orcidId: input.orcid_id });
+        let reviews;
+        try {
+            reviews = await service.getPeerReviews(input.orcid_id, ctx);
+        }
+        catch (err) {
+            if (err instanceof McpError && err.code === JsonRpcErrorCode.NotFound) {
+                throw ctx.fail('profile_not_found', `ORCID iD ${normalizeOrcidId(input.orcid_id)} not found`);
+            }
+            throw err;
+        }
+        const bareId = normalizeOrcidId(input.orcid_id);
+        ctx.log.info('orcid_get_peer_reviews completed', {
+            orcidId: bareId,
+            reviewCount: reviews.length,
+        });
+        const notice = reviews.length === 0
+            ? 'No peer review records found. Coverage depends on researcher self-reporting and publisher participation in ORCID peer review import.'
+            : undefined;
+        return {
+            orcidId: bareId,
+            orcidUri: `https://orcid.org/${bareId}`,
+            reviewCount: reviews.length,
+            peerReviews: reviews,
+            ...(notice && { notice }),
+        };
+    },
+    format: (result) => {
+        const lines = [
+            `## Peer Reviews for ORCID ${result.orcidId}`,
+            `**URI:** ${result.orcidUri}`,
+            `**Total Reviews:** ${result.reviewCount}`,
+        ];
+        if (result.notice) {
+            lines.push('', `> ${result.notice}`);
+        }
+        if (result.peerReviews.length === 0) {
+            return [{ type: 'text', text: lines.join('\n') }];
+        }
+        lines.push('');
+        for (const r of result.peerReviews) {
+            const orgName = r.conveningOrganization?.name ?? 'Unknown organization';
+            lines.push(`### ${orgName}`);
+            if (r.reviewerRole)
+                lines.push(`**Role:** ${r.reviewerRole}`);
+            if (r.reviewType)
+                lines.push(`**Type:** ${r.reviewType}`);
+            if (r.completionDate)
+                lines.push(`**Completed:** ${r.completionDate}`);
+            if (r.groupIssn)
+                lines.push(`**Journal ISSN:** ${r.groupIssn}`);
+            if (r.reviewUrl)
+                lines.push(`**URL:** ${r.reviewUrl}`);
+            // Render all conveningOrganization sub-fields for format parity
+            if (r.conveningOrganization?.city)
+                lines.push(`**Org City:** ${r.conveningOrganization.city}`);
+            if (r.conveningOrganization?.country)
+                lines.push(`**Org Country:** ${r.conveningOrganization.country}`);
+            if (r.conveningOrganization?.disambiguatedId) {
+                lines.push(`**Org ID:** ${r.conveningOrganization.disambiguatedId} (${r.conveningOrganization.disambiguationSource ?? 'unknown source'})`);
+            }
+            lines.push('');
+        }
+        return [{ type: 'text', text: lines.join('\n') }];
+    },
+});
+//# sourceMappingURL=get-peer-reviews.tool.js.map

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

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

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

@@ -0,0 +1,39 @@
+/**
+ * @fileoverview Fetch a researcher's public profile from ORCID: name, biography,
+ * keywords, researcher URLs, and external identifiers (Scopus ID, ResearcherID, etc.).
+ * @module mcp-server/tools/definitions/get-profile.tool
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+export declare const orcidGetProfile: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    orcid_id: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    orcidId: z.ZodString;
+    orcidUri: z.ZodString;
+    givenNames: z.ZodOptional<z.ZodString>;
+    familyName: z.ZodOptional<z.ZodString>;
+    creditName: z.ZodOptional<z.ZodString>;
+    biography: z.ZodOptional<z.ZodString>;
+    keywords: z.ZodArray<z.ZodString>;
+    researcherUrls: z.ZodArray<z.ZodObject<{
+        name: z.ZodOptional<z.ZodString>;
+        url: z.ZodString;
+    }, z.core.$strip>>;
+    externalIdentifiers: z.ZodArray<z.ZodObject<{
+        type: z.ZodString;
+        value: z.ZodString;
+        url: z.ZodOptional<z.ZodString>;
+        relationship: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    emails: z.ZodArray<z.ZodObject<{
+        email: z.ZodString;
+        primary: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>;
+    countries: z.ZodArray<z.ZodString>;
+}, z.core.$strip>, readonly [{
+    readonly reason: "profile_not_found";
+    readonly code: JsonRpcErrorCode.NotFound;
+    readonly when: "The ORCID iD does not correspond to a registered researcher.";
+    readonly recovery: "Verify the ORCID iD is correct and try orcid_search_researchers to find valid iDs.";
+}]>;
+//# sourceMappingURL=get-profile.tool.d.ts.map

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

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

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

@@ -0,0 +1,146 @@
+/**
+ * @fileoverview Fetch a researcher's public profile from ORCID: name, biography,
+ * keywords, researcher URLs, and external identifiers (Scopus ID, ResearcherID, etc.).
+ * @module mcp-server/tools/definitions/get-profile.tool
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode, McpError } from '@cyanheads/mcp-ts-core/errors';
+import { getOrcidService, normalizeOrcidId } from '../../../services/orcid/orcid-service.js';
+export const orcidGetProfile = tool('orcid_get_profile', {
+    title: 'Get ORCID Researcher Profile',
+    description: "Fetch a researcher's public profile from ORCID: name, biography, keywords, researcher URLs, and external identifiers such as Scopus Author ID, ResearcherID, and Loop profile. This is the entry point for building a researcher dossier. Pass a bare ORCID iD (0000-0001-2345-6789) or a full URI (https://orcid.org/0000-0001-2345-6789). The profile contains only publicly visible data — researchers control visibility per field.",
+    annotations: { readOnlyHint: true, openWorldHint: false, idempotentHint: true },
+    input: z.object({
+        orcid_id: z
+            .string()
+            .regex(/^(https?:\/\/orcid\.org\/)?\d{4}-\d{4}-\d{4}-\d{3}[\dX]$/, 'Must be a valid ORCID iD (e.g. 0000-0001-2345-6789) or full ORCID URI.')
+            .describe('ORCID iD — bare format (0000-0001-2345-6789) or full URI (https://orcid.org/0000-0001-2345-6789).'),
+    }),
+    output: z.object({
+        orcidId: z.string().describe('Normalized ORCID iD (bare format without URI prefix).'),
+        orcidUri: z.string().describe('Full ORCID URI (https://orcid.org/{id}).'),
+        givenNames: z.string().optional().describe('Given (first) name, if publicly visible.'),
+        familyName: z.string().optional().describe('Family (last) name, if publicly visible.'),
+        creditName: z.string().optional().describe('Published credit name, if set.'),
+        biography: z.string().optional().describe('Researcher biography, if publicly visible.'),
+        keywords: z
+            .array(z.string().describe('Keyword term.'))
+            .describe('Research keywords set by the researcher.'),
+        researcherUrls: z
+            .array(z
+            .object({
+            name: z.string().optional().describe('Label for this URL.'),
+            url: z.string().describe('URL value.'),
+        })
+            .describe('Researcher URL entry.'))
+            .describe('Researcher-provided URLs (personal site, lab page, blog, etc.).'),
+        externalIdentifiers: z
+            .array(z
+            .object({
+            type: z
+                .string()
+                .describe('Identifier type (e.g. Scopus Author ID, ResearcherID, Loop).'),
+            value: z.string().describe('Identifier value.'),
+            url: z.string().optional().describe('Resolver URL for this identifier, if provided.'),
+            relationship: z.string().optional().describe('Relationship type (self or part-of).'),
+        })
+            .describe('External identifier linking to another scholarly system.'))
+            .describe('External identifiers from scholarly systems (Scopus, Web of Science, Loop, etc.).'),
+        emails: z
+            .array(z
+            .object({
+            email: z.string().describe('Email address.'),
+            primary: z
+                .boolean()
+                .optional()
+                .describe('True when this is the primary email address.'),
+        })
+            .describe('Email address entry.'))
+            .describe('Publicly visible email addresses.'),
+        countries: z
+            .array(z.string().describe('ISO 3166-1 alpha-2 country code.'))
+            .describe("Countries listed in the researcher's address section."),
+    }),
+    errors: [
+        {
+            reason: 'profile_not_found',
+            code: JsonRpcErrorCode.NotFound,
+            when: 'The ORCID iD does not correspond to a registered researcher.',
+            recovery: 'Verify the ORCID iD is correct and try orcid_search_researchers to find valid iDs.',
+        },
+    ],
+    async handler(input, ctx) {
+        const service = getOrcidService();
+        ctx.log.info('orcid_get_profile', { orcidId: input.orcid_id });
+        let person;
+        try {
+            person = await service.getPerson(input.orcid_id, ctx);
+        }
+        catch (err) {
+            if (err instanceof McpError && err.code === JsonRpcErrorCode.NotFound) {
+                throw ctx.fail('profile_not_found', `ORCID iD ${normalizeOrcidId(input.orcid_id)} not found`);
+            }
+            throw err;
+        }
+        const bareId = normalizeOrcidId(input.orcid_id);
+        ctx.log.info('orcid_get_profile completed', {
+            orcidId: bareId,
+            hasName: !!(person.givenNames || person.familyName),
+            keywordCount: person.keywords.length,
+            externalIdCount: person.externalIdentifiers.length,
+        });
+        return {
+            orcidId: bareId,
+            orcidUri: `https://orcid.org/${bareId}`,
+            ...(person.givenNames && { givenNames: person.givenNames }),
+            ...(person.familyName && { familyName: person.familyName }),
+            ...(person.creditName && { creditName: person.creditName }),
+            ...(person.biography && { biography: person.biography }),
+            keywords: person.keywords,
+            researcherUrls: person.researcherUrls,
+            externalIdentifiers: person.externalIdentifiers,
+            emails: person.emails,
+            countries: person.countries,
+        };
+    },
+    format: (result) => {
+        const lines = [`## ORCID Profile: ${result.orcidId}`];
+        const nameParts = [result.givenNames, result.familyName].filter(Boolean);
+        if (nameParts.length)
+            lines.push(`**Name:** ${nameParts.join(' ')}`);
+        if (result.creditName)
+            lines.push(`**Credit Name:** ${result.creditName}`);
+        lines.push(`**ORCID URI:** ${result.orcidUri}`);
+        if (result.biography) {
+            lines.push('', '### Biography', result.biography);
+        }
+        if (result.keywords.length) {
+            lines.push('', `**Keywords:** ${result.keywords.join(', ')}`);
+        }
+        if (result.externalIdentifiers.length) {
+            lines.push('', '### External Identifiers');
+            for (const id of result.externalIdentifiers) {
+                const rel = id.relationship ? ` [${id.relationship}]` : '';
+                const line = `- **${id.type}:** ${id.value}${id.url ? ` (${id.url})` : ''}${rel}`;
+                lines.push(line);
+            }
+        }
+        if (result.researcherUrls.length) {
+            lines.push('', '### Researcher URLs');
+            for (const ru of result.researcherUrls) {
+                lines.push(`- ${ru.name ? `**${ru.name}:** ` : ''}${ru.url}`);
+            }
+        }
+        if (result.emails.length) {
+            lines.push('', '### Emails');
+            for (const e of result.emails) {
+                lines.push(`- ${e.email}${e.primary ? ' (primary)' : ''}`);
+            }
+        }
+        if (result.countries.length) {
+            lines.push('', `**Countries:** ${result.countries.join(', ')}`);
+        }
+        return [{ type: 'text', text: lines.join('\n') }];
+    },
+});
+//# sourceMappingURL=get-profile.tool.js.map

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

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

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

@@ -0,0 +1,35 @@
+/**
+ * @fileoverview Retrieve works (publications, datasets, software, preprints, etc.)
+ * associated with an ORCID iD. Returns titles, types, dates, journal names, and
+ * external identifiers ready for chaining to Crossref, PubMed, or arXiv.
+ * @module mcp-server/tools/definitions/get-works.tool
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+export declare const orcidGetWorks: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    orcid_id: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    orcidId: z.ZodString;
+    orcidUri: z.ZodString;
+    workCount: z.ZodNumber;
+    works: z.ZodArray<z.ZodObject<{
+        title: z.ZodOptional<z.ZodString>;
+        workType: z.ZodOptional<z.ZodString>;
+        publicationDate: z.ZodOptional<z.ZodString>;
+        journalTitle: z.ZodOptional<z.ZodString>;
+        url: z.ZodOptional<z.ZodString>;
+        externalIds: z.ZodArray<z.ZodObject<{
+            type: z.ZodString;
+            value: z.ZodString;
+            url: z.ZodOptional<z.ZodString>;
+            relationship: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    notice: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, readonly [{
+    readonly reason: "profile_not_found";
+    readonly code: JsonRpcErrorCode.NotFound;
+    readonly when: "The ORCID iD does not correspond to a registered researcher.";
+    readonly recovery: "Verify the ORCID iD is correct and try orcid_search_researchers to find valid iDs.";
+}]>;
+//# sourceMappingURL=get-works.tool.d.ts.map

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

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

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

@@ -0,0 +1,127 @@
+/**
+ * @fileoverview Retrieve works (publications, datasets, software, preprints, etc.)
+ * associated with an ORCID iD. Returns titles, types, dates, journal names, and
+ * external identifiers ready for chaining to Crossref, PubMed, or arXiv.
+ * @module mcp-server/tools/definitions/get-works.tool
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode, McpError } from '@cyanheads/mcp-ts-core/errors';
+import { getOrcidService, normalizeOrcidId } from '../../../services/orcid/orcid-service.js';
+const ExternalIdSchema = z
+    .object({
+    type: z.string().describe('Identifier type (e.g. doi, pmid, arxiv, isbn).'),
+    value: z.string().describe('Identifier value.'),
+    url: z.string().optional().describe('Resolver URL for this identifier, if available.'),
+    relationship: z.string().optional().describe('Relationship to the work (self or part-of).'),
+})
+    .describe('External identifier for a work.');
+export const orcidGetWorks = tool('orcid_get_works', {
+    title: 'Get ORCID Researcher Works',
+    description: 'Retrieve works associated with an ORCID iD — publications, datasets, software, preprints, and more. Returns work summaries with titles, types, publication dates, journal names, and all external identifiers (DOIs, PMIDs, arXiv IDs, ISBNs). External IDs are ready for chaining to Crossref, PubMed, or arXiv servers. The /works endpoint returns summaries only — pass DOIs to Crossref or PMIDs to PubMed to retrieve full metadata or abstracts. Works are self-reported; a researcher may not have linked all their publications.',
+    annotations: { readOnlyHint: true, openWorldHint: false, idempotentHint: true },
+    input: z.object({
+        orcid_id: z
+            .string()
+            .regex(/^(https?:\/\/orcid\.org\/)?\d{4}-\d{4}-\d{4}-\d{3}[\dX]$/, 'Must be a valid ORCID iD (e.g. 0000-0001-2345-6789) or full ORCID URI.')
+            .describe('ORCID iD — bare format (0000-0001-2345-6789) or full URI (https://orcid.org/0000-0001-2345-6789).'),
+    }),
+    output: z.object({
+        orcidId: z.string().describe('Normalized ORCID iD (bare format).'),
+        orcidUri: z.string().describe('Full ORCID URI.'),
+        workCount: z.number().describe('Total number of works returned.'),
+        works: z
+            .array(z
+            .object({
+            title: z.string().optional().describe('Work title.'),
+            workType: z
+                .string()
+                .optional()
+                .describe('Work type (e.g. journal-article, dataset, software, preprint).'),
+            publicationDate: z
+                .string()
+                .optional()
+                .describe('Publication date (YYYY, YYYY-MM, or YYYY-MM-DD).'),
+            journalTitle: z.string().optional().describe('Journal or container title.'),
+            url: z.string().optional().describe('URL for the work, if available.'),
+            externalIds: z
+                .array(ExternalIdSchema)
+                .describe('External identifiers (DOIs, PMIDs, arXiv IDs, ISBNs, etc.).'),
+        })
+            .describe('Work summary record.'))
+            .describe('Works associated with this ORCID iD.'),
+        notice: z
+            .string()
+            .optional()
+            .describe('Note when the works list is empty — may indicate no self-reported works or private visibility settings.'),
+    }),
+    errors: [
+        {
+            reason: 'profile_not_found',
+            code: JsonRpcErrorCode.NotFound,
+            when: 'The ORCID iD does not correspond to a registered researcher.',
+            recovery: 'Verify the ORCID iD is correct and try orcid_search_researchers to find valid iDs.',
+        },
+    ],
+    async handler(input, ctx) {
+        const service = getOrcidService();
+        ctx.log.info('orcid_get_works', { orcidId: input.orcid_id });
+        let works;
+        try {
+            works = await service.getWorks(input.orcid_id, ctx);
+        }
+        catch (err) {
+            if (err instanceof McpError && err.code === JsonRpcErrorCode.NotFound) {
+                throw ctx.fail('profile_not_found', `ORCID iD ${normalizeOrcidId(input.orcid_id)} not found`);
+            }
+            throw err;
+        }
+        const bareId = normalizeOrcidId(input.orcid_id);
+        ctx.log.info('orcid_get_works completed', { orcidId: bareId, workCount: works.length });
+        const notice = works.length === 0
+            ? 'No works found. The researcher may not have linked works to their ORCID record, or works may be set to private visibility.'
+            : undefined;
+        return {
+            orcidId: bareId,
+            orcidUri: `https://orcid.org/${bareId}`,
+            workCount: works.length,
+            works,
+            ...(notice && { notice }),
+        };
+    },
+    format: (result) => {
+        const lines = [
+            `## Works for ORCID ${result.orcidId}`,
+            `**URI:** ${result.orcidUri}`,
+            `**Total Works:** ${result.workCount}`,
+        ];
+        if (result.notice) {
+            lines.push('', `> ${result.notice}`);
+        }
+        if (result.works.length === 0) {
+            return [{ type: 'text', text: lines.join('\n') }];
+        }
+        lines.push('');
+        for (const w of result.works) {
+            lines.push(`### ${w.title ?? '(untitled)'}`);
+            if (w.workType)
+                lines.push(`**Type:** ${w.workType}`);
+            if (w.publicationDate)
+                lines.push(`**Date:** ${w.publicationDate}`);
+            if (w.journalTitle)
+                lines.push(`**Journal:** ${w.journalTitle}`);
+            if (w.url)
+                lines.push(`**URL:** ${w.url}`);
+            if (w.externalIds.length) {
+                const idParts = w.externalIds.map((id) => {
+                    const rel = id.relationship ? ` [${id.relationship}]` : '';
+                    const urlPart = id.url ? ` (${id.url})` : '';
+                    return `${id.type}:${id.value}${urlPart}${rel}`;
+                });
+                lines.push(`**IDs:** ${idParts.join(', ')}`);
+            }
+            lines.push('');
+        }
+        return [{ type: 'text', text: lines.join('\n') }];
+    },
+});
+//# sourceMappingURL=get-works.tool.js.map

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

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

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

@@ -0,0 +1,46 @@
+/**
+ * @fileoverview Disambiguate an author name to a verified ORCID iD. Returns a
+ * ranked candidate list with transparent disambiguation signals: name match type,
+ * institution overlap, and anchor type (doi/pmid/none).
+ * @module mcp-server/tools/definitions/resolve-researcher.tool
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+export declare const orcidResolveResearcher: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    name: z.ZodString;
+    affiliation: z.ZodOptional<z.ZodString>;
+    doi: z.ZodOptional<z.ZodString>;
+    pmid: z.ZodOptional<z.ZodString>;
+    rows: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>, z.ZodObject<{
+    candidates: z.ZodArray<z.ZodObject<{
+        orcidId: z.ZodString;
+        orcidUri: z.ZodString;
+        givenNames: z.ZodOptional<z.ZodString>;
+        familyNames: z.ZodOptional<z.ZodString>;
+        creditName: z.ZodOptional<z.ZodString>;
+        institutionNames: z.ZodArray<z.ZodString>;
+        nameMatchType: z.ZodEnum<{
+            "other-name": "other-name";
+            none: "none";
+            exact: "exact";
+            partial: "partial";
+        }>;
+        institutionOverlap: z.ZodBoolean;
+        anchorType: z.ZodEnum<{
+            none: "none";
+            doi: "doi";
+            pmid: "pmid";
+        }>;
+    }, z.core.$strip>>;
+    queryUsed: z.ZodString;
+    relaxedQuery: z.ZodOptional<z.ZodString>;
+    totalFound: z.ZodNumber;
+    notice: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, readonly [{
+    readonly reason: "no_candidates";
+    readonly code: JsonRpcErrorCode.NotFound;
+    readonly when: "No ORCID records matched even the relaxed query for this name.";
+    readonly recovery: "Try a different name spelling, use orcid_search_researchers with broader parameters, or verify the DOI/PMID is correct.";
+}]>;
+//# sourceMappingURL=resolve-researcher.tool.d.ts.map

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

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