altmetric-mcp — Claude Code MCP server
Connects an AI agent to Altmetric APIs for tracking research attention across news, policy documents, social platforms, and other sources.
claude mcp add --transport http altmetric-mcp https://mcp.altmetric.com/mcpWhat altmetric-mcp does
altmetric-mcp exposes Altmetric’s Details Page API and Explorer API to an AI agent. It can inspect attention for a specific output by DOI or PubMed ID, break results down by source, and search or aggregate outputs, mentions, journals, and audience data.
The hosted option uses https://mcp.altmetric.com/mcp and sends the user through browser-based OAuth. Available tools follow the permissions on the Altmetric account. A local setup runs through npx and uses Altmetric API credentials directly. Without access to an API, the related product tools cannot be provided.
The server calls Altmetric’s own APIs. X mentions expose numeric IDs, counts, and aggregate demographics, while account names and post text are withheld.
What it helps with
- look up attention for a DOI
- separate news attention from policy attention
- find research outputs cited in policy documents
- map the audience locations for a research topic
Example prompts for the agent
- Use Altmetric to measure attention for DOI
10.1038/nature12373and break it down by source. - Find research outputs mentioned in policy documents during the last month.
- List my institution’s research outputs with news coverage and rank them by attention.
How to install altmetric-mcp
1Platform CLI: remote server
claude mcp add --transport http altmetric-mcp https://mcp.altmetric.com/mcp2Platform CLI
claude mcp add --env ALTMETRIC_DETAILS_API_KEY=<ALTMETRIC_DETAILS_API_KEY> --env ALTMETRIC_EXPLORER_API_KEY=<ALTMETRIC_EXPLORER_API_KEY> --env ALTMETRIC_EXPLORER_API_SECRET=<ALTMETRIC_EXPLORER_API_SECRET> --transport stdio altmetric-mcp -- npx -y altmetric-mcpReplace <…> with your own values
1Platform CLI: remote server
codex mcp add altmetric-mcp --url https://mcp.altmetric.com/mcp2Platform CLI
codex mcp add altmetric-mcp --env ALTMETRIC_DETAILS_API_KEY=<ALTMETRIC_DETAILS_API_KEY> --env ALTMETRIC_EXPLORER_API_KEY=<ALTMETRIC_EXPLORER_API_KEY> --env ALTMETRIC_EXPLORER_API_SECRET=<ALTMETRIC_EXPLORER_API_SECRET> -- npx -y altmetric-mcpReplace <…> with your own values
Config file
{
"mcpServers": {
"altmetric-mcp": {
"url": "https://mcp.altmetric.com/mcp"
}
}
}{
"mcpServers": {
"altmetric-mcp": {
"command": "npx",
"args": [
"-y",
"altmetric-mcp"
],
"env": {
"ALTMETRIC_DETAILS_API_KEY": "<ALTMETRIC_DETAILS_API_KEY>",
"ALTMETRIC_EXPLORER_API_KEY": "<ALTMETRIC_EXPLORER_API_KEY>",
"ALTMETRIC_EXPLORER_API_SECRET": "<ALTMETRIC_EXPLORER_API_SECRET>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"altmetric-mcp": {
"type": "http",
"url": "https://mcp.altmetric.com/mcp"
}
}
}{
"servers": {
"altmetric-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"altmetric-mcp"
],
"env": {
"ALTMETRIC_DETAILS_API_KEY": "<ALTMETRIC_DETAILS_API_KEY>",
"ALTMETRIC_EXPLORER_API_KEY": "<ALTMETRIC_EXPLORER_API_KEY>",
"ALTMETRIC_EXPLORER_API_SECRET": "<ALTMETRIC_EXPLORER_API_SECRET>"
}
}
}
}Replace <…> with your own values
1Platform CLI: remote server
gemini mcp add -t http altmetric-mcp https://mcp.altmetric.com/mcp2Platform CLI
gemini mcp add -e ALTMETRIC_DETAILS_API_KEY=<ALTMETRIC_DETAILS_API_KEY> -e ALTMETRIC_EXPLORER_API_KEY=<ALTMETRIC_EXPLORER_API_KEY> -e ALTMETRIC_EXPLORER_API_SECRET=<ALTMETRIC_EXPLORER_API_SECRET> altmetric-mcp npx -y altmetric-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 altmetric-mcp
How do I install altmetric-mcp in Claude Code?
Run claude mcp add --transport http altmetric-mcp https://mcp.altmetric.com/mcp. Then open /mcp in Claude Code, choose altmetric-mcp, and complete browser sign-in.
What does altmetric-mcp do?
It gives Claude Code and other MCP clients access to Altmetric APIs. An agent can investigate research attention, source mentions, policy references, and audience data.
What information is available for X mentions?
The server can return numeric IDs, counts, and aggregate demographics. It does not provide account names or post text.
