Recommend related papers
recommend_papersPapers related to one or more origin papers, found through their citation network (co-citation and bibliographic coupling). Pass Paper Nexus ids from search_papers, or papernex.us/paper/ links. Several origins merge their related papers, with papers related to more than one of them first; origins from unrelated fields give a mix of each field's papers, not papers bridging them. Results are listed most related first: the order weighs how strongly each paper is linked to the origins (for well-connected origins, over a sample of their citers and references) and, without filters, also damps very highly cited papers and lifts recent ones. It orders this one list; it is not a probability of relevance or a measure of scientific importance. Each paper's evidence gives the citation links behind it, with link_counts saying how many co-citations and shared references link it to each origin, out of what each origin's sampled says was read: weigh a paper held up by few of them accordingly. graph_url opens the whole graph in Paper Nexus, which can hold more papers than limit. Pass fields to get only the details of each paper you need. With filters, every related paper passes them, best match first; years are the only date precision. To keep to papers linked to every origin, pass the origins as filters.cites with cites_match "all" (papers citing all of them), or narrow by topic with filters.title.
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": {
"papers": "<papers>"
},
"name": "recommend_papers"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | ||
| fields | No | Only these fields of each paper, to keep the result short; the id always comes back. Leave it out for every field. | |
| papers | Yes | Paper Nexus paper ids, or papernex.us/paper/<id> links | |
| filters | No | Only return papers that pass every filter given here. The search goes deeper than the plain recommendations to fill the list, so pass filters here rather than filtering the results yourself. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| filters | No | The filters applied, as understood | |
| origins | Yes | ||
| graph_url | Yes | ||
| not_found | No | ||
| filter_summary | No | ||
| recommendations | Yes |