Get Article
get_articleRetrieves an article's Europe PMC open-access XML as JATS sections with a text budget, preserving headings and IDs; non-OA items return metadata and abstract only.
Instructions
Retrieve available Europe PMC OA XML as JATS sections, with a total text budget.
Returns abstract and sections preserving headings, IDs and parent IDs. include_text=False returns the section directory plus bounded abstract. Metadata-reported XML availability can fail (see warnings). Non-OA articles return available metadata/abstract only. Use get_article_section with section.id and next_offset to read omitted text.
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": {
"identifier": "<identifier>"
},
"name": "get_article"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| max_chars | No | Maximum returned text characters; metadata is additional. | |
| identifier | Yes | Bare DOI, DOI: prefix, https://doi.org/ URL, PMID digits/PMID:digits, or PMCID PMCdigits; arbitrary URLs and WOS: IDs are rejected. | |
| include_text | No | Include bounded section text; false returns the section directory and abstract. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | ||
| doi | Yes | ||
| url | Yes | ||
| pmid | Yes | ||
| year | No | ||
| pmcid | Yes | ||
| title | Yes | ||
| access | Yes | ||
| source | Yes | ||
| authors | No | ||
| license | Yes | ||
| abstract | Yes | ||
| sections | Yes | ||
| warnings | Yes | ||
| retrieval | Yes | ||
| license_url | No | ||
| text_budget | Yes | ||
| bibliography | Yes | Additive common metadata; null means the authoritative value is unavailable. | |
| oa_locations | Yes | ||
| abstract_truncated | No | ||
| abstract_total_chars | No |