Altmetric MCP

Name: Altmetric MCP
Author: Altmetric

AltmetricOfficial

Lets agents query Altmetric APIs for attention and citation data on research outputs across news, policy and social media.

Setup

Choose your client, copy the config, then fill in any required environment variables.

Add to Cursor Add to VS Code

Local

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

~/.codex/config.toml

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

# codex mcp add altmetric --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-mcp

~/.cursor/mcp.json

{
  "mcpServers": {
    "altmetric": {
      "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>"
      }
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "altmetric": {
      "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>"
      }
    }
  }
}

~/.gemini/settings.json

{
  "mcpServers": {
    "altmetric": {
      "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>"
      }
    }
  }
}

claude_desktop_config.json

{
  "mcpServers": {
    "altmetric": {
      "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>"
      }
    }
  }
}

.trae/mcp.json

{
  "mcpServers": {
    "altmetric": {
      "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>"
      }
    }
  }
}

Remote

claude mcp add --transport http altmetric https://mcp.altmetric.com/mcp

~/.codex/config.toml

[mcp_servers.altmetric]
url = "https://mcp.altmetric.com/mcp"

# codex mcp add altmetric --url https://mcp.altmetric.com/mcp

~/.cursor/mcp.json

{
  "mcpServers": {
    "altmetric": {
      "url": "https://mcp.altmetric.com/mcp"
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "altmetric": {
      "type": "http",
      "url": "https://mcp.altmetric.com/mcp"
    }
  }
}

~/.gemini/settings.json

{
  "mcpServers": {
    "altmetric": {
      "httpUrl": "https://mcp.altmetric.com/mcp"
    }
  }
}

claude_desktop_config.json · Customize › Connectors › Add custom connector

{
  "mcpServers": {
    "altmetric": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.altmetric.com/mcp"
      ]
    }
  }
}

.trae/mcp.json

{
  "mcpServers": {
    "altmetric": {
      "url": "https://mcp.altmetric.com/mcp"
    }
  }
}

Environment variables

ALTMETRIC_DETAILS_API_KEY
ALTMETRIC_EXPLORER_API_KEY
ALTMETRIC_EXPLORER_API_SECRET

Replace the placeholders with your own credentials and keep them out of version control.

Setup

Local

Remote

Environment variables

Related