{"serverId":"mcp-registry/app.hypepaper/hypepaper","tools":[{"name":"api_get","fixed":{"name":"api_get","description":"Call one read-only HypePaper API route from api_catalog as yourself and return its JSON. Free responses are cut at 24 KB. [Free · 1 credit]","inputSchema":{"type":"object","required":["path"],"properties":{"path":{"type":"string","maxLength":500,"minLength":1,"description":"A route from api_catalog with its path params filled in, e.g. /api/v1/papers/<uuid>/results-arena (the /api/v1 prefix is optional)."},"params":{"type":"object","description":"Query parameters: scalars or lists of scalars."}},"additionalProperties":false},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":157,"tokensAfter":157},{"name":"api_get_llm","fixed":{"name":"api_get_llm","description":"Call one LLM-backed HypePaper API route (explain, tldr, translate, lit-review, briefing, …) from api_catalog and return its JSON. [Free · 5 credits + AI credits]","inputSchema":{"type":"object","required":["path"],"properties":{"path":{"type":"string","maxLength":500,"minLength":1,"description":"A route from api_catalog with its path params filled in, e.g. /api/v1/papers/<uuid>/results-arena (the /api/v1 prefix is optional)."},"params":{"type":"object","description":"Query parameters: scalars or lists of scalars."}},"additionalProperties":false},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":164,"tokensAfter":164},{"name":"compare_on_benchmark","fixed":{"name":"compare_on_benchmark","description":"Compare 2–5 papers head-to-head on the datasets and metrics they share; returns wins, losses and the evidence rows. Only complete, matching experimental protocols are compared. coverage has one row per paper: comparison_status compared, no_shared_lane (its stored lanes are listed) or no_stored_result. A number not returned here is not stored; say so, never supply it. [Free · 8 credits]","inputSchema":{"type":"object","required":["paper_ids"],"properties":{"paper_ids":{"type":"array","items":{"type":"string"},"maxItems":5,"minItems":2},"dataset_key":{"type":"string"}},"additionalProperties":false},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":181,"tokensAfter":181},{"name":"expert_search_facts","fixed":{"name":"expert_search_facts","description":"Full-text search over an expert's graph nodes — claims, results, methods, datasets, metrics, papers — ranked, with the source paper of each hit. Filter with types (e.g. Paper, Method, Algorithm, Model, PerformanceClaim, Result). The entry point for node ids; cheaper than expert_ask when you want facts, not prose. [Free · 1 credit]","inputSchema":{"type":"object","required":["topic_id","q"],"properties":{"q":{"type":"string","maxLength":300,"minLength":2},"limit":{"type":"integer","default":30,"maximum":100,"minimum":1},"types":{"type":"array","items":{"type":"string","maxLength":60},"maxItems":10,"description":"Node types to keep (exact)."},"topic_id":{"type":"string","description":"Topic id of an expert (from list_experts)."}},"additionalProperties":false},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":226,"tokensAfter":226},{"name":"fetch","fixed":{"name":"fetch","description":"Read one view by its hp:// pointer — from list_views, or from an expert_ask citation — sliced in the database to at most max_tokens (≤2,500): a TL;DR, key ideas (one by #index), a deep-analysis section (analysis/<lang>/Q3, a subsection by #slug), result rows (results?ds=&metric=), a SOTA lane, a comparison, a note (current, or @v<history_id>), a story or synthesis section. Full text pages by offset. A missing view comes back empty with a reason. [Free · 1 credit]","inputSchema":{"type":"object","required":["uri"],"properties":{"uri":{"type":"string","maxLength":500,"minLength":6},"lang":{"enum":["en","ko","ja","zh-Hans","es"],"type":"string","default":"en","description":"Serve the localized row when one exists, else English (lang_served says which)."},"offset":{"type":"integer","default":0,"minimum":0,"description":"Full text only: the character to start from."},"max_tokens":{"type":"integer","default":1500,"maximum":2500,"minimum":50}},"additionalProperties":false},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":282,"tokensAfter":282},{"name":"get_paper","fixed":{"name":"get_paper","description":"Paper detail by UUID or arXiv id: abstract, authors, venue, hype and citation counts, GitHub stars, quick summary, benchmark rows and any SOTA takes. [Free · 1 credit]","inputSchema":{"type":"object","required":["paper_id"],"properties":{"paper_id":{"type":"string","description":"UUID or arXiv id like 2401.12345"}},"additionalProperties":false},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":107,"tokensAfter":107},{"name":"library_compare_methods","fixed":{"name":"library_compare_methods","description":"Your personal library: Side-by-side comparison of methods: for each method id, list the papers that use it and outbound claim nodes. [Free · 1 credit]","inputSchema":{"type":"object","required":["method_ids"],"properties":{"method_ids":{"type":"array","items":{"type":"string"}}},"additionalProperties":false},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":100,"tokensAfter":100},{"name":"library_find_contradictions","fixed":{"name":"library_find_contradictions","description":"Your personal library: Find claims that contradict the input. Pass either a claim kg_node id (returns contradictions of that single claim) or a HypePaper papers.id (returns contradictions of any of the paper's claims). Walks 'contradicts_claim' edges in either direction. [Free · 1 credit]","inputSchema":{"type":"object","required":["claim_id_or_paper_id"],"properties":{"claim_id_or_paper_id":{"type":"string"}},"additionalProperties":false},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":139,"tokensAfter":139},{"name":"library_find_extending_papers","fixed":{"name":"library_find_extending_papers","description":"Your personal library: Find papers that extend or improve on the given paper's methods/algorithms. Use when the user asks 'what's been done since paper X?' or 'who extended this method?'. paper_id is the HypePaper papers.id (not the kg_nodes id). [Free · 1 credit]","inputSchema":{"type":"object","required":["paper_id"],"properties":{"paper_id":{"type":"string"}},"additionalProperties":false},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":125,"tokensAfter":125},{"name":"library_get_paper_content","fixed":{"name":"library_get_paper_content","description":"Your personal library: Fetch a paper's title, abstract, GitHub stats, AND its full deep-analysis markdown (the per-paper structured writeup with method, findings, numbers, limitations). Call this after `search_nodes` returns a Paper hit when you need to quote specific numbers, methods, or limitations from the paper rather than just the abstract. Returns the user's preferred-language version of the analysis (falls back to English). [Free · 1 credit]","inputSchema":{"type":"object","required":["paper_id"],"properties":{"language":{"type":"string","description":"Optional BCP-47 language override (e.g. 'ko', 'en'). Defaults to the user's preferred language with English as fallback."},"paper_id":{"type":"string","description":"Either the papers.id UUID OR a kg_node id pointing at a Paper node (e.g. the `id` field from a `search_nodes` Paper hit, or the `source_paper.id` enriched payload)."},"max_chars":{"type":"integer","default":8000,"description":"Truncate the deep-analysis body to this many characters to bound context cost. Lower it when calling for multiple papers at once."}},"additionalProperties":false},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":326,"tokensAfter":326},{"name":"library_search_nodes","fixed":{"name":"library_search_nodes","description":"Your personal library: Search the research knowledge graph for nodes matching a free-text query. Returns enriched node payloads ({id, type, name, aliases, description, source_paper}) plus 1-hop edges around the top hits. Use this first when you need to find papers, methods, or concepts by topic. [Free · 1 credit]","inputSchema":{"type":"object","required":["query"],"properties":{"kinds":{"type":"array","items":{"type":"string"},"description":"Optional layer filter on metadata.kind. Use to drill into a specific knowledge layer: ['editorial_insight'] (Layer 1 Insights), ['layer2_domain_synthesis'] (Layer 2 Domain Syntheses), ['layer3_paper_draft'] (Layer 3 Paper Drafts / Agentic Research). Combine values for multi-layer queries."},"query":{"type":"string"},"top_k":{"type":"integer","default":25},"node_type":{"type":"string","description":"Optional filter: Paper | Method | Concept | Dataset | Benchmark | PerformanceClaim | ..."},"include_edges":{"type":"boolean","default":true,"description":"When true (default), also return 1-hop edges around the top hits as relationship triples."}},"additionalProperties":false},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":326,"tokensAfter":326},{"name":"library_stats","fixed":{"name":"library_stats","description":"Your personal library: Summary statistics about the requesting user's tracked-paper library: total paper count, top years, top venues, recent titles, most-starred, AND most_connected_papers (top-5 by kg_edge degree — answers 'which paper has the most connections'). Use FIRST whenever the user asks anything about THEIR library size, distribution, recent additions, or graph connectivity. Always library-scoped — no node_id inputs needed. [Free · 1 credit]","inputSchema":{"type":"object","properties":{},"additionalProperties":false},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":160,"tokensAfter":160},{"name":"list_experts","fixed":{"name":"list_experts","description":"Topics that have a ready expert (name, layer, papers ingested, last built). Use before expert_notes / expert_ask. [Free · 1 credit]","inputSchema":{"type":"object","properties":{"limit":{"type":"integer","default":50,"maximum":100,"minimum":1}},"additionalProperties":false},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":87,"tokensAfter":87},{"name":"list_views","fixed":{"name":"list_views","description":"What HypePaper holds about a paper, topic, note, editor story or area synthesis, as hp:// pointers with token estimates, without the text: TL;DR, key ideas, methods, each deep-analysis section (Q1 problem … Q6 summary), result rows, SOTA brief and lanes, tables, figure captions, comparisons, notes. Pass hp://paper/<id>, hp://topic/<id>, hp://note/<id>, hp://story/<id>, hp://synthesis/<id>, or a paper UUID / arXiv id. Then fetch the views you need. [Free · 1 credit]","inputSchema":{"type":"object","required":["uri"],"properties":{"uri":{"type":"string","maxLength":500,"minLength":6},"lang":{"enum":["en","ko","ja","zh-Hans","es"],"type":"string","default":"en","description":"Serve the localized row when one exists, else English (lang_served says which)."}},"additionalProperties":false},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":231,"tokensAfter":231},{"name":"search","fixed":{"name":"search","description":"Search the whole HypePaper corpus: papers (keyword matches ranked by keyword+embedding fusion; nearest by meaning when no paper matches the words), plus matching topics, authors, datasets, affiliations and a topic expert if one exists. Start here. [Free · 1 credit]","inputSchema":{"type":"object","required":["q"],"properties":{"q":{"type":"string","maxLength":300,"minLength":1},"sort":{"enum":["relevance","hype","recent"],"type":"string","default":"relevance"},"limit":{"type":"integer","default":10,"maximum":25,"minimum":1},"offset":{"type":"integer","default":0,"minimum":0},"year_max":{"type":"integer"},"year_min":{"type":"integer"}},"additionalProperties":false},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":196,"tokensAfter":196},{"name":"sota_check","fixed":{"name":"sota_check","description":"Is this paper (or a dataset+metric+value) state of the art? Returns the current leader and who has beaten it since under the same experimental conditions. Missing protocol evidence or peers yields an unknown verdict. [Free · 8 credits]","inputSchema":{"type":"object","anyOf":[{"required":["paper_id"]},{"required":["dataset_key","metric","value","condition"]}],"properties":{"value":{"type":"number"},"metric":{"type":"string"},"paper_id":{"type":"string"},"condition":{"type":"string","description":"Exact protocol key from dataset_leaderboard; required for an explicit value"},"dataset_key":{"type":"string"}},"additionalProperties":false},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":189,"tokensAfter":189}],"toolsChanged":16,"tokensSaved":0,"todo":[{"tool":"affiliation_profile","params":["limit","org_key"]},{"tool":"api_catalog","params":["q","limit","section"]},{"tool":"author_papers","params":["page","sort","page_size"]},{"tool":"benchmark_timeline","params":["metric","dataset"]},{"tool":"citation_graph","params":["page","paper_id","direction","page_size"]},{"tool":"citation_walk","params":["direction","max_nodes"]},{"tool":"coauthor_network","params":["depth"]},{"tool":"cocitation_recommendations","params":["limit"]},{"tool":"compare_on_benchmark","params":["paper_ids","dataset_key"]},{"tool":"conference_papers","params":["page","year","page_size"]},{"tool":"entity_trends","params":["days","limit","window","entity_type"]},{"tool":"expert_ask","params":["question","topic_id"]},{"tool":"expert_communities","params":["limit"]},{"tool":"expert_graph_map","params":["query","budget"]},{"tool":"expert_node_context","params":["depth"]},{"tool":"expert_notes","params":["q","topic_id"]},{"tool":"expert_search_facts","params":["q","limit"]},{"tool":"expert_verify_claim","params":["object","subject"]},{"tool":"fetch","params":["uri","max_tokens"]},{"tool":"lane_leaders","params":["limit"]},{"tool":"library_claims_for_paper","params":["paper_id","claim_type"]},{"tool":"library_compare_methods","params":["method_ids"]},{"tool":"library_emergent_topics","params":["limit"]},{"tool":"library_filter","params":["node_ids"]},{"tool":"library_find_contradictions","params":["claim_id_or_paper_id"]},{"tool":"library_find_extending_papers","params":["paper_id"]},{"tool":"library_node_context","params":["depth","node_id"]},{"tool":"library_papers_with_concept","params":["concept_id"]},{"tool":"library_papers_with_method","params":["method_id"]},{"tool":"library_search_nodes","params":["query","top_k"]},{"tool":"library_synthesize_papers","params":["prompt","paper_ids"]},{"tool":"library_timeline","params":["kind","query"]},{"tool":"list_experts","params":["limit"]},{"tool":"list_views","params":["uri"]},{"tool":"new_sota","params":["limit"]},{"tool":"paper_fulltext","params":["limit","offset","paper_id"]},{"tool":"paper_references","params":["page","page_size"]},{"tool":"search","params":["q","sort","limit","offset","year_max","year_min"]},{"tool":"similar_papers","params":["limit","paper_id"]},{"tool":"sota_changelog","params":["limit"]},{"tool":"sota_check","params":["value","metric","paper_id","dataset_key"]},{"tool":"sota_walk","params":["max_hops","paper_id","direction"]},{"tool":"trending_papers","params":["sort","limit","window"]}],"note":"Deterministic fixes. Changes marked verify need a human look before shipping (renames, inferred annotations, inferred types, removed text). Parameter descriptions in `todo` need to be written by someone who knows the API."}