Dimensions Analytics — Claude Code MCP server: how to install
Connects Dimensions DSL to your coding agent for research data analysis. It lets you query scientific publications, grants, patents, clinical trials, and researchers.
claude mcp add --env DIMENSIONS_API_KEY=<DIMENSIONS_API_KEY> --env DIMENSIONS_BASE_URL=<DIMENSIONS_BASE_URL> --transport stdio mcp -- npx -y @digital-science-dsl/dimensions-analytics-mcpWhat Dimensions Analytics does
The MCP server runs the @digital-science-dsl/dimensions-analytics-mcp package via npx over stdio transport. It hooks into the Dimensions DSL so your agent can query research intelligence directly. You can inspect author profiles, evaluate funding sources, or review patent records.
Authentication relies on the DIMENSIONS_API_KEY environment variable. Custom Dimensions deployments also require DIMENSIONS_BASE_URL to route requests away from default endpoints.
What it helps with
- Search scientific publications and citation metrics
- Retrieve researcher profiles and affiliations
- Track project grants and funding details
- Inspect patent records and clinical trials
Example prompts for the agent
- Search Dimensions for recent publications and patents on perovskite solar cells
- Find active grants and funding history for this research institution in Dimensions
- Pull clinical trial records related to mRNA vaccines using Dimensions
How to install Dimensions Analytics
Platform CLI
claude mcp add --env DIMENSIONS_API_KEY=<DIMENSIONS_API_KEY> --env DIMENSIONS_BASE_URL=<DIMENSIONS_BASE_URL> --transport stdio mcp -- npx -y @digital-science-dsl/dimensions-analytics-mcpReplace <…> with your own values
Platform CLI
codex mcp add mcp --env DIMENSIONS_API_KEY=<DIMENSIONS_API_KEY> --env DIMENSIONS_BASE_URL=<DIMENSIONS_BASE_URL> -- npx -y @digital-science-dsl/dimensions-analytics-mcpReplace <…> with your own values
Config file
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@digital-science-dsl/dimensions-analytics-mcp"
],
"env": {
"DIMENSIONS_API_KEY": "<DIMENSIONS_API_KEY>",
"DIMENSIONS_BASE_URL": "<DIMENSIONS_BASE_URL>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@digital-science-dsl/dimensions-analytics-mcp"
],
"env": {
"DIMENSIONS_API_KEY": "<DIMENSIONS_API_KEY>",
"DIMENSIONS_BASE_URL": "<DIMENSIONS_BASE_URL>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e DIMENSIONS_API_KEY=<DIMENSIONS_API_KEY> -e DIMENSIONS_BASE_URL=<DIMENSIONS_BASE_URL> mcp npx -y @digital-science-dsl/dimensions-analytics-mcpReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Dimensions Analytics
How do I install Dimensions Analytics in Claude Code?
Run claude mcp add analytics-mcp -e DIMENSIONS_API_KEY=<DIMENSIONS_API_KEY> -- npx -y @digital-science-dsl/dimensions-analytics-mcp. For private installations, use `claude mcp add --env DIMENSIONS_API_KEY=<DIMENSIONS_API_KEY> --env DIMENSIONS_BASE_URL=<DIMENSIONS_BASE_URL> --transport stdio mcp -- npx -y @digital-science-dsl/dimensions-analytics-mcp`.
What does Dimensions Analytics do?
It exposes the Dimensions DSL to your AI assistant. This enables direct queries across research publications, grants, patents, clinical studies, and investigator profiles.
When do I need to set DIMENSIONS_BASE_URL?
Set DIMENSIONS_BASE_URL only when connecting to a custom Dimensions deployment. Standard cloud setups require just the DIMENSIONS_API_KEY.
