Altmetric MCP
MCP server for Altmetric APIs - track research attention across news, policy, social media, and more
Connector by mcp.altmetric.comOfficial · Domain verified by the MCP Registry
Install
Works with Claude Code, VS Code, Codex, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.
npx agentmarket install connector/mcp-altmetric-com-altmetric-mcp
Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.
Remote endpoint
https://mcp.altmetric.com/mcpRemote (HTTP)
Get the weekly diff
The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.
About
Reviews
Write a reviewNo reviews yet. Installed it? Reviews come from verified installers only. How reviews work
Permissions
What this server can do and what it asks for, from its tool list and install config. Checked Oct 25, 2026.
- Tools
- 12 read · 0 write · 0 deleteRead-only
- Secrets
- 3 (API keys, tokens or passwords)
- Install scripts
- None found
- Runs as
- Node.js package
Tools by what they do 12
Read from the source code; the running server may list different tools.
Read 12 · Look things up without changing anything.
explore_attention_summaryexplore_demographicsexplore_journalsexplore_mention_sourcesexplore_mentionsexplore_research_outputsget_batch_attention_dataget_citation_countsget_citation_detailslist_departmentssearch_citationstranslate_identifiers
Secrets and settings it asks for
Secrets: values you paste in that let it act as you.
ALTMETRIC_DETAILS_API_KEYALTMETRIC_EXPLORER_API_KEYALTMETRIC_EXPLORER_API_SECRET
Network hosts it talks to 1
mcp.altmetric.com· found in remote endpoint, install command
Tools (12)
Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].
explore_attention_summaryread-onlyGet aggregated attention data for research outputs matching your query in Explorer. Returns total mentions across different sources (Twitter, news, blogs, etc.) broken down by date. This is a single-page endpoint with no pagination. Requires Explorer API credentials.
explore_demographicsread-onlyGet geographic distribution of mentions by country for specific mention sources. Use this to find where mentions originate from (e.g., which countries are tweeting about or covering research in the news). Supports X (tweet), Facebook (fbwall), news (msm), policy, and guideline demographics. Defaults to X if no source specified. Returns mention counts and unique sources per country. This is the only way to get mention-level country data; the countries filter on other endpoints filters by author affiliation country, not mention origin. Single-page endpoint, no pagination. Requires Explorer API c…
explore_journalsread-onlyGet aggregated mention data by journal. Returns journal names, ISSNs, and mention counts broken down by source type. This is a single-page endpoint with no pagination - it does not honor page[size], so a broad query aggregates every matching journal into one response (e.g. q="cancer" returns ~12,000 journals) and will be truncated to fit client size limits. Narrow it with filters (a more specific q, a timeframe, type, a publication date range, scope, or by scoping to specific identifiers) to keep the result complete. Requires Explorer API credentials.
explore_mention_sourcesread-onlyGet the number of mentions per mention source for research outputs matching your search. Analyze which platforms, channels, and outlets are mentioning research. X accounts are returned without a name: our licence with X allows only the numeric account id, so those sources appear as ids while news outlets, blogs, Bluesky and Reddit accounts come back named. Supports pagination. Requires Explorer API credentials.
explore_mentionsread-onlyGet individual mentions of research outputs from your Explorer search. Returns detailed information about each mention including author info, URLs, timestamps, and related research outputs. Mentions from X are the exception: under our licence with X we expose only the numeric post and account ids, never the account handle or the post text, so an X mention cannot be attributed to a named account through this API at any tier. Every other source (news, blogs, Bluesky, Reddit, podcasts, policy) names its author. Scored mentions also carry a sentiment-analysis attribute (one sentiment per research …
explore_research_outputsread-onlySearch research outputs in your Altmetric Explorer instance or across all Altmetric data. Supports full-text search, filtering by author, department, journal, publication date, research type, and more. Each result includes sentiment-analysis-totals, a breakdown of its mentions across seven sentiment categories (computed for X and Bluesky mentions; absent if your organization has AI features restricted). Note that altmetric-score here is rounded UP to a whole number, which is how Altmetric displays a score everywhere (details pages, badges, the Explorer itself), so 0.25 and 0.5 both come back a…
get_batch_attention_dataread-onlyGet attention metrics for multiple publications at once. Use this when comparing papers or finding which has most/least attention. Much more efficient than calling get_citation_counts multiple times.
get_citation_countsread-onlyRetrieve citation counts and basic metadata for a research output using its DOI, PubMed ID, arXiv ID, or other identifier. The score comes back unrounded (a single tweet scores 0.25), while Altmetric rounds it UP wherever it displays a score, so report 1 rather than 0.25 if the figure has to match what a customer sees on a details page, a badge or in the Explorer. Returns citation metrics across various platforms (Twitter, news, blogs, policy documents, etc.). Available with free tier API keys.
get_citation_detailsread-onlyRetrieve detailed citation information including full text of mentions, author details, and complete metadata for a research output. This is a commercial feature requiring a paid API key. Returns comprehensive data about each mention across all tracked platforms. Posts from X carry only `tweet_id` and `author.tweeter_id`, with no account name or post text, under our licence with X; posts from other sources carry the author name and a summary. The citation block includes authors_details, pairing each author name with its Dimensions Researcher ID where available. Note: This endpoint does not sup…
list_departmentsread-onlyList the institutional departments in your Altmetric Explorer instance. Returns every department with its id and name; use a department's id as a value for the department_id filter on the other Explorer tools (e.g. explore_research_outputs). Only available to institutions with a data integration (PURE, Elements, OAI-PMH, or CSV); institutions without one return an empty list. Takes no arguments and fetches every page for you, returning your institution's full department set. Requires Explorer API credentials.
search_citationsread-onlySearch and retrieve aggregated citation data across all tracked research outputs for a specific timeframe. Returns lists of outputs sorted by citation counts, filtered by various criteria. Available with free tier API keys.
translate_identifiersread-onlyTranslate research output identifiers (DOIs, PMIDs, arXiv IDs, etc.) into Altmetric IDs. Useful for discovering which identifiers Altmetric has data for. Supports batch translation of up to 100,000 identifiers per request. The identifier type is auto-detected. This is a commercial feature requiring a paid API key.
Compare and alternatives
Featured in
Signals
- Stars
- 7
- Forks
- 0
- Open issues
- 0
- Last commit
- Oct 14, 2026 (14 days ago)
- Last release
- Oct 14, 2026 (14 days ago)
From GitHub (fetched Oct 24, 2026).
Details
- Registry name
com.altmetric.mcp/altmetric-mcp- Version
- 1.2.4
- Auth
- Auth not stated, API key
- Packages
- npm altmetric-mcp
- License
- MIT
- Repository
- github.com/altmetric/altmetric-mcp
- First seen
- Oct 24, 2026
- Last checked
- Oct 24, 2026
Cite this page
Altmetric MCP. Agent Mart. https://agentmart.dev/connectors/mcp-altmetric-com-altmetric-mcp (last updated 2026-10-24)