@digital-science-dsl/dimensions-analytics-mcp 0.5.3

package/dist/mcp/tools/policy-profile.js

@@ -0,0 +1,174 @@
+/**
+ * Policy document profile tool for the MCP server.
+ * Provides deep profiling of policy documents including structural links
+ * to cited publications and their supporting grants.
+ * @module mcp/tools/policy-profile
+ */
+import { ErrorCode, McpError } from "@modelcontextprotocol/sdk/types.js";
+import { z } from "zod";
+import { asArray, formatErrorResult, formatToolResult, READ_ONLY_API_ANNOTATIONS, } from "../utils.js";
+/**
+ * Registers the policy_document_profile tool with the MCP server.
+ * @param server - MCP server instance
+ * @param client - Dimensions client instance
+ */
+export function registerPolicyProfileTools(server, client) {
+    server.registerTool("policy_document_profile", {
+        description: "Get a comprehensive profile for a policy document including its cited publications and their supporting grants. Uses structural links (publication_ids) rather than free-text search to trace the evidence chain from policy back to funded research.",
+        inputSchema: {
+            policyDocId: z.string().optional().describe("Dimensions policy document ID"),
+            query: z
+                .string()
+                .optional()
+                .describe("Search term to find policy documents (used when policyDocId is not known)"),
+            includeLinkedPublications: z
+                .boolean()
+                .default(true)
+                .describe("Include cited publications and their supporting grants"),
+            publicationLimit: z
+                .number()
+                .int()
+                .min(1)
+                .max(50)
+                .default(20)
+                .describe("Max linked publications to return"),
+        },
+        outputSchema: {
+            found: z.boolean().describe("Whether the policy document was found"),
+            profile: z
+                .record(z.string(), z.unknown())
+                .optional()
+                .describe("Policy document profile with linked entities"),
+            message: z.string().optional().describe("Message when not found"),
+        },
+        annotations: READ_ONLY_API_ANNOTATIONS,
+    }, async (args) => {
+        if (!args.policyDocId && !args.query) {
+            throw new McpError(ErrorCode.InvalidParams, "Must provide at least one of: policyDocId or query");
+        }
+        try {
+            // Step 1: Find the policy document
+            let policyDsl;
+            if (args.policyDocId) {
+                policyDsl = client
+                    .createQueryBuilder()
+                    .search("policy_documents")
+                    .where("id", "=", args.policyDocId)
+                    .fields([
+                    "id",
+                    "title",
+                    "year",
+                    "publisher_org",
+                    "linkout",
+                    "publisher_org",
+                    "publication_ids",
+                ])
+                    .limit(1)
+                    .build();
+            }
+            else {
+                policyDsl = client
+                    .createQueryBuilder()
+                    .search("policy_documents")
+                    .for(args.query)
+                    .fields([
+                    "id",
+                    "title",
+                    "year",
+                    "publisher_org",
+                    "linkout",
+                    "publisher_org",
+                    "publication_ids",
+                ])
+                    .limit(5)
+                    .build();
+            }
+            const policyResponse = await client.rawQuery(policyDsl);
+            const policyDocs = asArray(policyResponse.policy_documents);
+            if (policyDocs.length === 0) {
+                return formatToolResult({
+                    found: false,
+                    message: args.policyDocId
+                        ? `No policy document found with ID: ${args.policyDocId}`
+                        : `No policy document found matching: ${args.query}`,
+                });
+            }
+            const policyDoc = policyDocs[0];
+            const profile = {
+                policyDocument: policyDoc,
+                matchCount: policyDocs.length,
+            };
+            // Extract structural link IDs
+            const publicationIds = Array.isArray(policyDoc.publication_ids)
+                ? policyDoc.publication_ids
+                : undefined;
+            // Step 2: Fetch linked publications
+            if (args.includeLinkedPublications !== false &&
+                publicationIds &&
+                publicationIds.length > 0) {
+                const pubSlice = publicationIds.slice(0, args.publicationLimit);
+                const pubDsl = client
+                    .createQueryBuilder()
+                    .search("publications")
+                    .whereIn("id", pubSlice)
+                    .fields([
+                    "id",
+                    "title",
+                    "doi",
+                    "year",
+                    "times_cited",
+                    "journal",
+                    "authors",
+                    "research_orgs",
+                    "funders",
+                    "supporting_grant_ids",
+                ])
+                    .limit(args.publicationLimit)
+                    .build();
+                const pubResponse = await client.rawQuery(pubDsl);
+                const publications = asArray(pubResponse.publications);
+                profile.linkedPublications = {
+                    totalLinked: publicationIds.length,
+                    returnedCount: publications.length,
+                    items: publications,
+                };
+                // Second-wave: fetch grants behind the publications
+                const allGrantIds = new Set();
+                for (const pub of publications) {
+                    if (Array.isArray(pub.supporting_grant_ids)) {
+                        for (const gid of pub.supporting_grant_ids) {
+                            if (typeof gid === "string") {
+                                allGrantIds.add(gid);
+                            }
+                        }
+                    }
+                }
+                if (allGrantIds.size > 0) {
+                    const grantIds = [...allGrantIds].slice(0, 50);
+                    const grantDsl = client
+                        .createQueryBuilder()
+                        .search("grants")
+                        .whereIn("id", grantIds)
+                        .fields(["id", "title", "funding_usd", "funder_org_name", "start_year"])
+                        .limit(50)
+                        .build();
+                    const grantResponse = await client.rawQuery(grantDsl);
+                    const grants = asArray(grantResponse.grants);
+                    profile.supportingGrants = {
+                        totalLinked: allGrantIds.size,
+                        returnedCount: grants.length,
+                        items: grants,
+                    };
+                }
+            }
+            return formatToolResult({
+                found: true,
+                profile,
+            });
+        }
+        catch (error) {
+            return formatErrorResult(error);
+        }
+    });
+}
+//# sourceMappingURL=policy-profile.js.map

package/dist/mcp/tools/policy-profile.js.map

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

package/dist/mcp/tools/profile.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Profile tools for the MCP server.
+ * Provides researcher and organization profile aggregation.
+ * @module mcp/tools/profile
+ */
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { DimensionsClient } from "../../dsl/index.js";
+/**
+ * Registers all profile tools with the MCP server.
+ * @param server - MCP server instance
+ * @param client - Dimensions client instance
+ */
+export declare function registerProfileTools(server: McpServer, client: DimensionsClient): void;
+//# sourceMappingURL=profile.d.ts.map

package/dist/mcp/tools/profile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/profile.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGzE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAQ3D;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAwYtF"}

package/dist/mcp/tools/profile.js

@@ -0,0 +1,349 @@
+/**
+ * Profile tools for the MCP server.
+ * Provides researcher and organization profile aggregation.
+ * @module mcp/tools/profile
+ */
+import { ErrorCode, McpError } from "@modelcontextprotocol/sdk/types.js";
+import { z } from "zod";
+import { asArray, formatErrorResult, formatToolResult, READ_ONLY_API_ANNOTATIONS, } from "../utils.js";
+/**
+ * Registers all profile tools with the MCP server.
+ * @param server - MCP server instance
+ * @param client - Dimensions client instance
+ */
+export function registerProfileTools(server, client) {
+    // Author/Researcher Profile
+    server.registerTool("author_profile", {
+        description: "Get a comprehensive profile for a researcher including their publications, grants, and institutional affiliations. Search by name or ORCID.",
+        inputSchema: {
+            researcherId: z.string().optional().describe("Dimensions researcher ID (if known)"),
+            orcid: z.string().optional().describe("ORCID identifier (e.g., '0000-0001-2345-6789')"),
+            name: z
+                .string()
+                .optional()
+                .describe("Researcher name to search for (e.g., 'Jennifer Doudna')"),
+            includePublications: z
+                .boolean()
+                .default(true)
+                .describe("Include recent publications in profile"),
+            includeGrants: z.boolean().default(true).describe("Include grants in profile"),
+            publicationLimit: z
+                .number()
+                .int()
+                .min(1)
+                .max(100)
+                .default(20)
+                .describe("Max publications to return"),
+            grantLimit: z.number().int().min(1).max(100).default(10).describe("Max grants to return"),
+        },
+        outputSchema: {
+            found: z.boolean().describe("Whether the researcher was found"),
+            profile: z
+                .record(z.string(), z.unknown())
+                .optional()
+                .describe("Aggregated researcher profile"),
+            message: z.string().optional().describe("Message when not found"),
+        },
+        annotations: READ_ONLY_API_ANNOTATIONS,
+    }, async (args) => {
+        // Validate that at least one identifier is provided
+        if (!args.researcherId && !args.orcid && !args.name) {
+            throw new McpError(ErrorCode.InvalidParams, "Must provide at least one of: researcherId, orcid, or name");
+        }
+        try {
+            // Step 1: Find the researcher
+            let researcherDsl;
+            if (args.researcherId) {
+                researcherDsl = client
+                    .createQueryBuilder()
+                    .search("researchers")
+                    .where("id", "=", args.researcherId)
+                    .limit(1)
+                    .build();
+            }
+            else if (args.orcid) {
+                researcherDsl = client
+                    .createQueryBuilder()
+                    .search("researchers")
+                    .where("orcid_id", "=", args.orcid)
+                    .limit(1)
+                    .build();
+            }
+            else {
+                const name = args.name;
+                if (!name) {
+                    throw new McpError(ErrorCode.InvalidParams, "Must provide at least one of: researcherId, orcid, or name");
+                }
+                researcherDsl = client
+                    .createQueryBuilder()
+                    .search("researchers")
+                    .for(name)
+                    .limit(5)
+                    .build();
+            }
+            const researcherResponse = await client.rawQuery(researcherDsl);
+            const researchers = asArray(researcherResponse.researchers);
+            if (researchers.length === 0) {
+                return formatToolResult({
+                    found: false,
+                    message: args.name
+                        ? `No researcher found matching: ${args.name}`
+                        : `No researcher found with provided identifier`,
+                });
+            }
+            // Use the first/best match
+            const researcher = researchers[0];
+            if (typeof researcher.id !== "string") {
+                return formatErrorResult(new Error("API returned researcher record without a valid id field"));
+            }
+            const researcherId = researcher.id;
+            const profile = {
+                researcher,
+                matchCount: researchers.length,
+            };
+            // Steps 2 & 3: Get publications and grants concurrently
+            const queries = [];
+            if (args.includePublications) {
+                queries.push((async () => {
+                    const pubDsl = client
+                        .createQueryBuilder()
+                        .search("publications")
+                        .where("researchers.id", "=", researcherId)
+                        .fields(["id", "title", "doi", "year", "times_cited", "journal", "type"])
+                        .sort("year", "desc")
+                        .limit(args.publicationLimit)
+                        .build();
+                    const pubResponse = await client.rawQuery(pubDsl);
+                    const publications = asArray(pubResponse.publications);
+                    profile.publications = {
+                        totalCount: pubResponse._stats?.total_count ?? publications.length,
+                        returnedCount: publications.length,
+                        items: publications,
+                    };
+                })());
+            }
+            if (args.includeGrants) {
+                queries.push((async () => {
+                    const grantDsl = client
+                        .createQueryBuilder()
+                        .search("grants")
+                        .where("researchers.id", "=", researcherId)
+                        .fields(["id", "title", "funding_usd", "funder_org_name", "start_year"])
+                        .sort("start_year", "desc")
+                        .limit(args.grantLimit)
+                        .build();
+                    const grantResponse = await client.rawQuery(grantDsl);
+                    const grants = asArray(grantResponse.grants);
+                    profile.grants = {
+                        totalCount: grantResponse._stats?.total_count ?? grants.length,
+                        returnedCount: grants.length,
+                        items: grants,
+                    };
+                })());
+            }
+            await Promise.all(queries);
+            return formatToolResult({
+                found: true,
+                profile,
+            });
+        }
+        catch (error) {
+            return formatErrorResult(error);
+        }
+    });
+    // Organization Profile
+    server.registerTool("org_profile", {
+        description: "Get a comprehensive profile for a research organization including publication output, funding received, and top researchers. " +
+            "Prefer organizationId (GRID id) when known — common names can match multiple organizations.",
+        inputSchema: {
+            organizationId: z
+                .string()
+                .optional()
+                .describe("Dimensions organization GRID id (preferred, e.g. grid.168010.e for Stanford University)"),
+            name: z
+                .string()
+                .optional()
+                .describe("Organization name to search for (e.g., 'Stanford University', 'MIT')"),
+            includePublications: z.boolean().default(true).describe("Include recent publications"),
+            includeGrants: z.boolean().default(true).describe("Include grants received"),
+            includeTopResearchers: z
+                .boolean()
+                .default(true)
+                .describe("Include top researchers by publication count"),
+            publicationLimit: z
+                .number()
+                .int()
+                .min(1)
+                .max(100)
+                .default(20)
+                .describe("Max publications to return"),
+            grantLimit: z.number().int().min(1).max(100).default(10).describe("Max grants to return"),
+            researcherLimit: z
+                .number()
+                .int()
+                .min(1)
+                .max(50)
+                .default(10)
+                .describe("Max researchers to return"),
+        },
+        outputSchema: {
+            found: z.boolean().describe("Whether the organization was found"),
+            ambiguous: z
+                .boolean()
+                .optional()
+                .describe("True when name search matched multiple organizations"),
+            matchCount: z.number().optional().describe("Number of name matches returned"),
+            candidates: z
+                .array(z.record(z.string(), z.unknown()))
+                .optional()
+                .describe("Matching organizations when ambiguous (id and name)"),
+            profile: z
+                .record(z.string(), z.unknown())
+                .optional()
+                .describe("Aggregated organization profile"),
+            message: z.string().optional().describe("Message when not found or ambiguous"),
+        },
+        annotations: READ_ONLY_API_ANNOTATIONS,
+    }, async (args) => {
+        // Validate that at least one identifier is provided
+        if (!args.organizationId && !args.name) {
+            throw new McpError(ErrorCode.InvalidParams, "Must provide either organizationId or name");
+        }
+        try {
+            // Step 1: Find the organization
+            let orgDsl;
+            if (args.organizationId) {
+                orgDsl = client
+                    .createQueryBuilder()
+                    .search("organizations")
+                    .where("id", "=", args.organizationId)
+                    .limit(1)
+                    .build();
+            }
+            else {
+                const name = args.name;
+                if (!name) {
+                    throw new McpError(ErrorCode.InvalidParams, "Must provide either organizationId or name");
+                }
+                orgDsl = client.createQueryBuilder().search("organizations").for(name).limit(5).build();
+            }
+            const orgResponse = await client.rawQuery(orgDsl);
+            const organizations = asArray(orgResponse.organizations);
+            if (organizations.length === 0) {
+                return formatToolResult({
+                    found: false,
+                    message: args.name
+                        ? `No organization found matching: ${args.name}`
+                        : `No organization found with provided ID`,
+                });
+            }
+            if (!args.organizationId && organizations.length > 1) {
+                const candidates = organizations.map((org) => ({
+                    id: org.id,
+                    name: org.name,
+                }));
+                return formatToolResult({
+                    found: false,
+                    ambiguous: true,
+                    matchCount: organizations.length,
+                    candidates,
+                    message: `Name "${args.name}" matched ${organizations.length} organizations. ` +
+                        "Pass organizationId (GRID id) to disambiguate.",
+                });
+            }
+            const organization = organizations[0];
+            if (typeof organization.id !== "string") {
+                return formatErrorResult(new Error("API returned organization record without a valid id field"));
+            }
+            const orgId = organization.id;
+            const profile = {
+                organization,
+                matchCount: organizations.length,
+            };
+            // Steps 2, 3 & 4: Get publications, grants, and top researchers concurrently
+            const orgQueries = [];
+            if (args.includePublications) {
+                orgQueries.push((async () => {
+                    const pubDsl = client
+                        .createQueryBuilder()
+                        .search("publications")
+                        .where("research_orgs.id", "=", orgId)
+                        .fields(["id", "title", "doi", "year", "times_cited", "authors"])
+                        .sort("year", "desc")
+                        .limit(args.publicationLimit)
+                        .build();
+                    const pubResponse = await client.rawQuery(pubDsl);
+                    const publications = asArray(pubResponse.publications);
+                    profile.publications = {
+                        totalCount: pubResponse._stats?.total_count ?? publications.length,
+                        returnedCount: publications.length,
+                        items: publications,
+                    };
+                })());
+            }
+            if (args.includeGrants) {
+                orgQueries.push((async () => {
+                    const grantDsl = client
+                        .createQueryBuilder()
+                        .search("grants")
+                        .where("research_orgs.id", "=", orgId)
+                        .fields(["id", "title", "funding_usd", "funder_org_name", "start_year"])
+                        .sort("start_year", "desc")
+                        .limit(args.grantLimit)
+                        .build();
+                    const grantResponse = await client.rawQuery(grantDsl);
+                    const grants = asArray(grantResponse.grants);
+                    // Calculate total funding if available
+                    let totalFunding = 0;
+                    for (const grant of grants) {
+                        const funding = typeof grant.funding_usd === "number" ? grant.funding_usd : 0;
+                        if (funding > 0) {
+                            totalFunding += funding;
+                        }
+                    }
+                    profile.grants = {
+                        totalCount: grantResponse._stats?.total_count ?? grants.length,
+                        returnedCount: grants.length,
+                        totalFundingUsd: totalFunding,
+                        items: grants,
+                    };
+                })());
+            }
+            if (args.includeTopResearchers) {
+                orgQueries.push((async () => {
+                    const resDsl = client
+                        .createQueryBuilder()
+                        .search("researchers")
+                        .where("research_orgs.id", "=", orgId)
+                        .fields([
+                        "id",
+                        "first_name",
+                        "last_name",
+                        "orcid_id",
+                        "total_publications",
+                        "total_grants",
+                    ])
+                        .sort("total_publications", "desc")
+                        .limit(args.researcherLimit)
+                        .build();
+                    const resResponse = await client.rawQuery(resDsl);
+                    const researchers = asArray(resResponse.researchers);
+                    profile.topResearchers = {
+                        totalCount: resResponse._stats?.total_count ?? researchers.length,
+                        returnedCount: researchers.length,
+                        items: researchers,
+                    };
+                })());
+            }
+            await Promise.all(orgQueries);
+            return formatToolResult({
+                found: true,
+                profile,
+            });
+        }
+        catch (error) {
+            return formatErrorResult(error);
+        }
+    });
+}
+//# sourceMappingURL=profile.js.map

package/dist/mcp/tools/profile.js.map

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

package/dist/mcp/tools/query.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Query tools for the MCP server.
+ * Provides raw DSL query execution for power users.
+ * @module mcp/tools/query
+ */
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { type DimensionsClient } from "../../dsl/index.js";
+import type { SchemaStore } from "../schema/index.js";
+/**
+ * Registers the raw DSL query tool with the MCP server.
+ * @param server - MCP server instance
+ * @param client - Dimensions client instance
+ * @param schemaStore - Loaded describe schema for enriched descriptions
+ */
+export declare function registerQueryTools(server: McpServer, client: DimensionsClient, schemaStore: SchemaStore): void;
+//# sourceMappingURL=query.d.ts.map

package/dist/mcp/tools/query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/query.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,EAEL,KAAK,gBAAgB,EAEtB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAGtD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,gBAAgB,EACxB,WAAW,EAAE,WAAW,GACvB,IAAI,CAgEN"}