# MCP Endpoints

> Complete reference for all 36 MCP endpoints exposed by MCP Bond.

MCP Bond exposes 36 MCP endpoints organized into 8 categories. Once connected, your AI assistant can use any of these tools. Try some [example prompts](https://docs.valency.io/reference/examples.md).

## Search & Discovery

| Endpoint | Description | Sample Prompt |
|----------|-------------|---------------|
| `semantic_search_papers` | Search by meaning using semantic embeddings | Use Valency to find papers about making language models smaller and faster |
| `search_by_title` | Find papers by title keywords | Use Valency to find the paper titled Attention Is All You Need |
| `search_by_abstract` | Find papers by abstract content | Use Valency to find abstracts that mention tidal disruption flares |
| `search_by_abstract_batch` | Run multiple abstract searches in one call | Use Valency to search abstracts for solid-state, lithium-metal, and sodium-ion batteries |
| `search_by_author` | Find papers by author name (literal string matching) | Use Valency to show me papers with Risa Wechsler on the author list |
| `search_by_category` | Find papers in a research domain (recency-ordered) | Use Valency to show me papers in the astro-ph.HE category |
| `search_by_venue` | Search by publication venue (journal or conference) | Use Valency to show me papers published in The Lancet |
| `search_by_comments` | Search arXiv comments for venue acceptances, conference notes | Use Valency to find papers whose notes say accepted to NeurIPS 2025 |
| `search_cross_category` | Search abstracts across multiple categories | Use Valency to find network analysis papers spanning cs.LG and quant-ph |
| `find_similar_papers` | Find semantically similar papers to a given paper | Use Valency to find papers similar to arXiv 1706.03762 |
| `get_citing_papers` | Find papers that cite a given paper | Use Valency to find who has cited arXiv 1706.03762 since it came out |

## Filtering

| Endpoint | Description | Sample Prompt |
|----------|-------------|---------------|
| `filter_by_categories` | Filter across multiple domains (recency-ordered) | Use Valency to list recent papers across q-fin.PM and q-fin.RM |
| `filter_by_date_range` | Filter by publication date | Use Valency to list what came out between March 10 and March 12, 2025 |
| `filter_by_license` | Filter by license type (CC-BY, CC0, arXiv default, etc.) | Use Valency to show me CC0-licensed astro-ph.GA papers |
| `filter_papers_with_doi` | Find papers with DOI identifiers | Use Valency to show me math.GT papers that have DOIs assigned |
| `count_papers` | Count papers matching filters (number only) | Use Valency to count how many papers are in the corpus in total |

## Author Intelligence

| Endpoint | Description | Sample Prompt |
|----------|-------------|---------------|
| `get_author_profile` | Researcher profile: identity, career stats (h-index, affiliations), and corpus coverage. Look up by name, ORCID, or author ID | Use Valency to give me a research profile of the researcher with ORCID 0000-0003-2229-011X |
| `get_author_papers` | Find papers by a disambiguated researcher (more precise than `search_by_author`) | Use Valency to find every paper by the cosmologist Risa Wechsler, the specific researcher, not just anyone whose name matches |
| `get_author_coauthors` | Find an author's most frequent collaborators | Use Valency to find who Peter Nugent collaborates with most often |
| `compare_authors` | Compare 2–10 researchers side by side | Use Valency to compare Risa Wechsler and Peter Nugent side by side |
| `batch_author_categories` | Category distributions for multiple authors | Use Valency to show what fields Risa Wechsler, Peter Nugent, and Saul Perlmutter each publish in |
| `identify_prolific_authors` | Rank authors by publication count | Use Valency to find who publishes the most in astro-ph.GA |

:::note[Earlier tool names still work]
Clients set up with an earlier tool list keep working. `get_author_identity` and `resolve_orcid` are now part of `get_author_profile` (pass `orcid` to look up by ORCID), `find_papers_by_researcher` is now `get_author_papers`, and `find_coauthors` is now `get_author_coauthors`, where `include_mega_collaborations` replaces `exclude_mega_collaborations` (papers with more than 50 authors stay excluded by default).
:::

## Paper Details

| Endpoint | Description | Sample Prompt |
|----------|-------------|---------------|
| `get_paper_by_id` | Direct lookup by paper ID | Use Valency to pull up arXiv paper 1810.04805 |
| `get_paper_versions` | Revision history for a paper | Use Valency to check how many times arXiv 1706.03762 was revised |

## Trends & Analytics

| Endpoint | Description | Sample Prompt |
|----------|-------------|---------------|
| `get_keyword_trends` | Paper counts over time for a keyword/abstract search | Use Valency to show how diffusion model has grown in cs.LG abstracts |
| `get_publication_trends` | Paper counts over time for a category | Use Valency to show how publication volume in cs.AI has changed over time |
| `get_publication_trends_batch` | Trends for multiple categories in one call | Use Valency to compare yearly volume across cs.AI, cs.LG, and cs.CV |
| `analyze_corpus_metrics` | Corpus-wide descriptive statistics | Use Valency to report what share of papers have abstracts and DOIs |
| `identify_research_domains` | Rank research domains by volume | Use Valency to find which research domains are biggest on biorxiv |
| `get_field_coverage` | Most common values for a metadata field | Use Valency to find which journal names show up most in q-fin.ST |

## Corpus Info

| Endpoint | Description | Sample Prompt |
|----------|-------------|---------------|
| `list_sources` | Available paper sources with counts and date ranges | Use Valency to list which preprint servers and databases it covers |

## Export

| Endpoint | Description | Sample Prompt |
|----------|-------------|---------------|
| `export_papers_csv` | Export papers to CSV | Use Valency to export arXiv papers 1706.03762, 1810.04805, and 2005.14165 as CSV with titles and dates |
| `export_papers_json` | Export papers to JSON | Use Valency to export arXiv 1706.03762 as JSON |
| `export_papers_bibtex` | Export papers as BibTeX references | Use Valency to give me BibTeX for arXiv 1706.03762 |
| `export_from_filter` | Export papers matching a filter as in-memory content | Use Valency to export three CC-BY astro-ph.GA papers to CSV in one step |

## Feedback

| Endpoint | Description | Sample Prompt |
|----------|-------------|---------------|
| `submit_feedback` | Submit feedback about search quality, bugs, or feature requests | Use Valency to send feedback: the search results were great |

---

## Getting Started with Endpoints

Once you've [connected Valency](https://docs.valency.io/guides/claude.md) to your AI assistant, you can start using these endpoints immediately through natural language.

### Example queries

**Semantic search:**
> Use Valency to search for papers about transformer attention mechanisms

**Author research:**
> Use Valency to show me Geoffrey Hinton's publication profile

> Use Valency to find Yann LeCun's most frequent collaborators

**Trends:**
> Use Valency to show publication trends for machine learning over the last 5 years

**Filtering:**
> Use Valency to find papers about climate change from 2023 with CC-BY license

**Export:**
> Use Valency to export the top 100 papers about CRISPR to CSV

### Tips

- **Be specific**: More specific queries return better results
- **Combine endpoints**: Your AI assistant can chain multiple endpoints together
- **Use filters**: Narrow results by date, license, or category
- **Try semantic search first**: `semantic_search_papers` often gives the best results for exploratory queries