get_citation_metrics
Retrieve citation metrics from NIH iCite for PubMed articles, including citation count, RCR, percentile, and citations per year. Sort and filter results.
Instructions
Get citation metrics from NIH iCite for articles.
Returns field-normalized citation data including:
citation_count: Total number of citations
relative_citation_ratio (RCR): Field-normalized metric (1.0 = average)
nih_percentile: Percentile ranking (0-100)
citations_per_year: Citation velocity
apt: Approximate Potential to Translate (clinical relevance 0-1)
Can sort and filter results by citation metrics.
Args: pmids: PubMed IDs - accepts multiple formats: - "12345678,87654321" (comma-separated) - ["12345678", "87654321"] (list) - '["12345678", "87654321"]' (JSON array string) - "PMID:12345678" (with prefix) - "last" to use PMIDs from the last search Batches are fail-closed and limited to 1,000 items before deduplication. sort_by: Metric to sort by: - "citation_count": Raw citation count (default) - "relative_citation_ratio": Field-normalized (recommended) - "nih_percentile": Percentile ranking - "citations_per_year": Citation velocity min_citations: Filter out articles with fewer citations min_rcr: Filter out articles with RCR below threshold (e.g., 1.0 = average) min_percentile: Filter out articles below percentile (e.g., 50 = top half)
Returns: Articles with citation metrics, sorted and filtered as requested. iCite transport or response failures return an explicit retryable error and are never rendered as an empty/unindexed result.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"pmids": "<pmids>"
},
"name": "get_citation_metrics"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| pmids | Yes | ||
| min_rcr | No | ||
| sort_by | No | citation_count | |
| min_citations | No | ||
| output_format | No | markdown | |
| min_percentile | No |