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: Alchemy

by Alchemy

Alchemy's official remote MCP server: 168 tools for onchain data across 100+ chains — balances, NFTs, prices, portfolios, transaction simulation and execution traces.

Developer Tools

MCP: Scry

by Scry

Remote MCP server that lets an agent run read-only SQL over roughly 164 billion indexed documents from Reddit, Hacker News, arXiv, Wikipedia, Stack Exchange and prediction markets.

Web & Search

MCP: Data Commons MCP Server

by Data Commons

Query public statistics — health, economic, demographic and climate indicators from hundreds of official sources — through the Data Commons knowledge graph, hosted or self-run.

Databases & Data
Browse all MCP servers →