Marketing & SocialMCP Registrynpm12 toolsA · 85

altmetric-mcp

Name: altmetric-mcp
Author: mcp.altmetric.com

com.altmetric.mcp · Updated today

MCP server for Altmetric APIs - track research attention across news, policy, social media, and more

At a glance

altmetric-mcp is an MCP server in the Marketing & Social category. It runs locally over stdio via `npx -y altmetric-mcp`, and needs ALTMETRIC_DETAILS_API_KEY, ALTMETRIC_EXPLORER_API_KEY and ALTMETRIC_EXPLORER_API_SECRET. It exposes 12 tools, including get_citation_counts, get_citation_details and search_citations. It scores A (85/100) on the MCP Skills Hub health score as of Oct 28, 2026.

Source 7

One-click install

VS Code VS Code Insiders Cursor

Opens your editor and pre-fills the config. Your editor will ask before adding it.

How to install altmetric-mcp in your AI client

Setup for Claude Code, Claude Desktop, Cursor, Codex, Windsurf, Cline and VS Code — copy-paste ready.

How to install altmetric-mcp in Claude CodeAnthropic's agentic CLI

Add the server

bash

claude mcp add altmetric-mcp -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>' -- npx -y altmetric-mcp

Fill in your credentials
Replace <ALTMETRIC_DETAILS_API_KEY>, <ALTMETRIC_EXPLORER_API_KEY>, <ALTMETRIC_EXPLORER_API_SECRET> with your real values. Keep secrets out of any config file you commit.
3
Verify it's connected
bash
```
claude mcp list
```
Sharing it with your team?
Add `--scope project` to write it to .mcp.json in the repository root, which you can commit (with the secrets left as environment variables).
Use it in a session
Ask Claude to use the tools this server exposes (e.g. get_citation_counts, get_citation_details, search_citations). It discovers them automatically.

How to install altmetric-mcp in Claude DesktopDesktop app (MCP config)

Open your MCP config
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

Add this server

json

{
  "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>"
      }
    }
  }
}

Fill in your credentials
Replace <ALTMETRIC_DETAILS_API_KEY>, <ALTMETRIC_EXPLORER_API_KEY>, <ALTMETRIC_EXPLORER_API_SECRET> with your real values. Keep secrets out of any config file you commit.
Restart Claude Desktop
The tools appear under the 🔌 menu once the app reloads.

How to install altmetric-mcp in CursorAI-first code editor

Create / edit .cursor/mcp.json in your project

json

{
  "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>"
      }
    }
  }
}

Fill in your credentials
Replace <ALTMETRIC_DETAILS_API_KEY>, <ALTMETRIC_EXPLORER_API_KEY>, <ALTMETRIC_EXPLORER_API_SECRET> with your real values. Keep secrets out of any config file you commit.
Enable it
Cursor Settings → MCP → toggle the server on. Tools become available to the Composer/Agent.

How to install altmetric-mcp in Codex CLIOpenAI coding agent

Add to ~/.codex/config.toml

toml

[mcp_servers.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>" }

Fill in your credentials
Replace <ALTMETRIC_DETAILS_API_KEY>, <ALTMETRIC_EXPLORER_API_KEY>, <ALTMETRIC_EXPLORER_API_SECRET> with your real values. Keep secrets out of any config file you commit.
Run Codex
Codex loads MCP servers from config.toml on startup and exposes their tools to the agent.

How to install altmetric-mcp in WindsurfCodeium's agentic IDE

Edit ~/.codeium/windsurf/mcp_config.json

json

{
  "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>"
      }
    }
  }
}

Fill in your credentials
Replace <ALTMETRIC_DETAILS_API_KEY>, <ALTMETRIC_EXPLORER_API_KEY>, <ALTMETRIC_EXPLORER_API_SECRET> with your real values. Keep secrets out of any config file you commit.
Reload
Windsurf → Cascade → refresh MCP servers. Cascade can now call the tools.

How to install altmetric-mcp in ClineVS Code autonomous agent

Open Cline → MCP Servers → Configure
Adds to cline_mcp_settings.json.

Add the server

json

{
  "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>"
      }
    }
  }
}

Fill in your credentials
Replace <ALTMETRIC_DETAILS_API_KEY>, <ALTMETRIC_EXPLORER_API_KEY>, <ALTMETRIC_EXPLORER_API_SECRET> with your real values. Keep secrets out of any config file you commit.

How to install altmetric-mcp in VS CodeCopilot / MCP support

Create .vscode/mcp.json

json

{
  "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>"
      }
    }
  }
}

Fill in your credentials
Replace <ALTMETRIC_DETAILS_API_KEY>, <ALTMETRIC_EXPLORER_API_KEY>, <ALTMETRIC_EXPLORER_API_SECRET> with your real values. Keep secrets out of any config file you commit.
Start it
VS Code shows a ▶ Start action above the server entry. Agent mode (Copilot Chat) can then use the tools.

What does altmetric-mcp need from you?

API key — API key for Altmetric Details Page API. At least one credential set required: either this key OR both Explorer API credentials

ALTMETRIC_DETAILS_API_KEYoptionalsecretEnvironment variable
API key for Altmetric Details Page API. At least one credential set required: either this key OR both Explorer API credentials
ALTMETRIC_EXPLORER_API_KEYoptionalsecretEnvironment variable
API key for Altmetric Explorer API (requires ALTMETRIC_EXPLORER_API_SECRET). At least one credential set required
ALTMETRIC_EXPLORER_API_SECREToptionalsecretEnvironment variable
API secret for Altmetric Explorer API HMAC authentication (requires ALTMETRIC_EXPLORER_API_KEY)

Pass secrets through your shell environment rather than committing them into a config file.

What tools does altmetric-mcp expose? (12)

Taken from the project's README — the server itself was not queried, so check its docs for the exact schemas.

What the code can do

Read from the published package source — never executed. Parsed 14 of 14 source files.

This server can read and write files, make network requests and read your environment variables.

How it was published

No provenance attestation — there is nothing linking this published artifact to a specific source commit.
1 npm maintainer — a single point of compromise · last published by jbilbo.

Maintainer of this package and think something here is wrong? Tell us and we'll correct it.

Before you install

Signals gathered from the source repo and package registry — not a safety verdict.

What it can reach

Runs code on your machine — Executes as a local process with your user's permissions, including filesystem access.
Downloads at launch — The package is fetched from its registry each run unless you pin a version.

Last commit today — Actively maintained.
7 GitHub stars — Very little community usage so far.

Client compatibility

Claude Code: NativeClaude Desktop: NativeCursor: NativeCodex CLI: NativeWindsurf: NativeCline: NativeVS Code: Native

Health score

A · 85

Maintenance, adoption, transparency and packaging — not a safety audit. How this is calculated

Maintenance30%100%
Last commit 0 days ago.
Adoption20%27%
7 stars.
Transparency20%100%
4/4: ✓ public source repo, ✓ declared license, ✓ documentation, ✓ discoverable tool list.
Provenance15%100%
Package and registry entry point at the same repository.
Packaging15%100%
Publishes a pinned version (1.2.6).

Documentation

Full README

Altmetric MCP Server

Model Context Protocol (MCP) server that enables AI agents to access Altmetric APIs for tracking the attention and reach of research outputs across news outlets, policy documents, social media, and other online platforms.

Altmetric monitors where research is being discussed beyond traditional academic citations - from mainstream media coverage to policy citations, patent references, and social media engagement - providing a comprehensive view of real-world research impact.

There are two ways to connect:

Hosted server (recommended) - point your AI client at https://mcp.altmetric.com/mcp and sign in with your Altmetric account. No API keys to copy or store, and you automatically get the tools for whatever you have access to (Explorer, Details Page, or both). Start here.
Run locally - run the server on your own machine with your own API keys, over stdio. For offline use or when you'd rather manage keys directly. See *Run locally with your own API keys* below.

What access you need

The server works with access to either one of Altmetric's APIs on its own - the Details Page API or the Explorer API - and gives you the tools for whichever you have. To get the full potential of Altmetric, having both is strongly recommended, because they answer different questions:

Details Page API - the attention for a specific research output, looked up by identifier (DOI, PubMed ID, etc.), and a search of recent attention by timeframe.
Explorer API - searching, filtering and aggregating research outputs, mentions, audience demographics and journals across the whole Altmetric database, and across your own institution's outputs.

With only one, you get only that API's tools. See Tools for which tools come with each API, and request API access if you're missing one.

Connect to the hosted server (recommended)

The easiest way to use Altmetric in your AI client is the hosted server at https://mcp.altmetric.com/mcp. Point your client at that URL and sign in with your Altmetric account when prompted - the client runs a standard OAuth flow in your browser, so there are no API keys to copy or store. You get exactly the tools your account has access to.

Claude Desktop

Open Settings → Customize → Connectors and click Add custom connector.
Name it Altmetric and enter the URL https://mcp.altmetric.com/mcp.
Click Add, then Connect, and sign in when the browser window opens.

Verify by asking Claude: *"Use the Altmetric tools to look up the attention score for DOI 10.1038/nature12373"*

Excerpt — the full document is on GitHub.

Alternatives to altmetric-mcp

Maintain altmetric-mcp? Add a badge to your README

Shows its health grade, and links readers to install steps for every client.

markdown

[![altmetric-mcp on MCP Skills Hub](https://mcp-skills-hub.vercel.app/badge/com-altmetric-mcp-altmetric-mcp)](https://mcp-skills-hub.vercel.app/mcps/com-altmetric-mcp-altmetric-mcp)

Catalog data refreshed Oct 28, 2026. Something wrong? Report it.