Skip to content
Altmetric MCP Server

Altmetric MCP Server

by Altmetric
Released
MIT
Repository Docs npm
Web & Search

Summary

Altmetric's official MCP server for research attention data — news, policy documents, patents and social mentions of a paper — over a hosted OAuth endpoint or locally with your own API keys.

Features

  • Eleven read-only tools across the Details Page and Explorer APIs
  • Hosted OAuth 2.1 endpoint — no API keys to copy or store
  • Advertised tools match your account entitlements, so no tool fails on access
  • Attention metrics by DOI, PubMed ID and other identifiers
  • Policy, patent, news and social mention detail with author metadata
  • Local stdio mode with your own keys for offline or key-managed use

Installation

Set up this MCP server in your favorite AI agent — copy a ready-made configuration below.

Any MCP-compatible agent

Most agents (Claude, Cursor, Windsurf, VS Code, and more) read a standard mcpServers configuration.

  1. Open your agent's MCP configuration file.
  2. Merge the snippet below into it.
  3. Restart the agent — the "Altmetric MCP Server" tools will be available.
{
  "mcpServers": {
    "altmetric-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.altmetric.com/mcp"
      ]
    }
  }
}

Description

Altmetric tracks where research is discussed outside the citation graph: mainstream news, policy documents, patent references, clinical guidelines and social platforms. This official MCP server puts that data behind an agent, so a question like "who has cited this paper in policy since it was published?" becomes a tool call rather than a dashboard session.

Eleven tools across two APIs

From the Details Page API: get_citation_counts for attention metrics by DOI, PubMed ID or other identifier (free tier); search_citations to search attention data by timeframe (free); and, on commercial access, get_citation_details for full mention text and author metadata including Dimensions Researcher IDs, get_batch_attention_data for many DOIs at once, ranked, and translate_identifiers.

From the Explorer API, on institutional access: explore_research_outputs, explore_attention_summary, explore_mentions, explore_demographics for audience geography, explore_mention_sources for outlet analysis, explore_journals for journal metrics and rankings, and list_departments.

Hosted, with entitlement-aware tools

The recommended path is the hosted server at https://mcp.altmetric.com/mcp. It is an OAuth 2.1 resource server: your client obtains a bearer token from Altmetric Explorer for the mcp scope, and the server exchanges it for your account's entitlements — your token is never forwarded to the underlying APIs. The advertised toolset reflects what you can actually use, so an account with only Details Page access never sees Explorer tools it would fail on.

All tools are read-only, which means ChatGPT's read-only restriction on Plus and Pro plans does not limit them.

Or run it yourself

npx -y altmetric-mcp over stdio with ALTMETRIC_DETAILS_API_KEY and/or ALTMETRIC_EXPLORER_API_KEY plus secret. Node.js 20.6.0 or later. MIT licensed.

Related MCP Servers

MCP: X (Twitter)

by X

New

X's own hosted MCP server: full-archive post search, user and timeline lookup, trends, bookmarks and article drafting, under your account's permissions.

Web & Search
2 views

MCP: Apify Actors

by Apify

Featured

Apify's official MCP server — turn thousands of ready-made scrapers into tools your assistant can call.

Web & Search
1 views

MCP: Browserbase

by Browserbase

Featured

Browserbase's official MCP server — cloud browser automation with Stagehand's natural-language actions.

Web & Search
2 views
Browse all MCP servers →