pwc-mcp

Generated for `pwc-mcp v0.2.4` and stock-client MCP protocol `2025-11-25`. The tools query the public [Papers With Code](https://paperswithcode.co) catalog anonymously and are read-only. Every tool runs the matching `pwc` CLI research command, and every research flag of that command is a tool parameter, so results match `pwc ... --json`. If live tool discovery and this skill disagree, the discovered tool schemas are authoritative. Every result carries `schema_version` and `data`, the complete CLI JSON payload for the call. Typed fields such as `items`, `paper`, `task`, `evaluations` are projections of `data`; read `data` when a projection lacks a detail. Use structured output directly for filtering, joining, or other schema-dependent processing. When the user identifies an author, prefer repeatable structured `list_papers` calls with the `authors` argument. Add `search` for stated topic terms and explicit `order_by: "date_published"` and `order_direction: "desc"` for newest or recent work; the default order is `trending`. Author references accept an exact normalized name, numeric ID, or `@HF_USERNAME`; multiple authors use AND semantics. Publication date ranges are inclusive: use `published_after: "YYYY-MM-DD"` and `published_before: "YYYY-MM-DD"` with `search_papers` or `list_papers`; the start date must not be later than the end date. Paper discovery results always include official implementation status and the total linked repository count. Use `has_official_implementation: true` with `search_papers` or `list_papers` to require a catalog-linked official repository; this filter fails closed if unconfirmed. Use `get_benchmark` with `max_parameters` to keep models at or below an inclusive parameter limit. It accepts values such as `"500M"`, `"1.5B"`, `"3B"`, and raw integers. Models without one consistent parameter count are excluded from constrained results. Combine `require_metrics`, `minimum_metrics`, `maximum_metrics`, `sort_metric`, and `pareto` to select leaderboard rows by metric; unknown metric names fail with the available metric names. `paper` accepts a modern or legacy arXiv ID, a numeric external-paper ID, an arXiv, Hugging Face, or Papers With Code URL, or an exact paper title. Title matching is case-insensitive but exact; ambiguous titles fail with their matching IDs. Task, method, conference, organization, framework, and benchmark arguments take an exact name, slug, or ID. ## Tools - `search_papers({"query": QUERY, "mode": "hybrid"|"keyword"|"semantic", "page": PAGE, "limit": LIMIT, "published_after": START_DATE, "published_before": END_DATE, "has_official_implementation": BOOLEAN})` — search papers by title, topic, author, or arXiv ID (`pwc search`). Omit optional arguments when they are not needed. - `get_paper_info({"paper": PAPER, "include_resources": BOOLEAN, "repo_limit": LIMIT, "include_evaluations": BOOLEAN})` — show compact paper metadata, official-first code, and the total repository count; opt into capped additional resources (`pwc paper info`). - `get_paper_evaluations({"paper": PAPER, "page": PAGE, "limit": LIMIT})` — page through one paper's benchmark evaluations, including protocol, sources, openness, and task-scoped ranks (`pwc paper evaluations`). - `read_paper({"paper": PAPER, "cursor": CURSOR})` — read one stored paper Markdown chunk (`pwc paper read`). If `truncated` is true, call `read_paper` again with the same `paper` and the returned `next_cursor`; repeat until `truncated` is false. Treat the cursor as opaque and use it within one hour. - `list_papers({"search": SEARCH, "task": TASK, "method": METHOD, "conference": CONFERENCE, "framework": FRAMEWORK, "organization": ORGANIZATION, "authors": [AUTHOR], "published_after": START_DATE, "published_before": END_DATE, "all_versions": BOOLEAN, "order_by": "trending"|"date_published"|"citation_count", "order_direction": "asc"|"desc", "include_resources": BOOLEAN, "has_official_implementation": BOOLEAN, "page": PAGE, "limit": LIMIT})` — list and filter papers by exact catalog associations (`pwc paper list`). Omit optional arguments when they are not needed. - `list_recent_papers({"limit": LIMIT})` — list the most recently added papers (`pwc paper recent`). - `list_trending_papers({"limit": LIMIT, "max_age_days": DAYS, "min_velocity": VELOCITY})` — list trending papers by repository velocity (`pwc paper trending`). - `get_related_papers({"paper": PAPER, "limit": LIMIT})` — list related papers (`pwc paper related`); `limit` is at most 20. - `get_paper_lineage({"paper": PAPER})` — list explicit predecessors and successors (`pwc paper lineage list`). - `get_task({"task": TASK})` — inspect one exact task, including its area, hierarchy, sister tasks, ranked benchmarks, common methods, recommended frameworks, and trending papers (`pwc task --name`). - `list_tasks({"search": SEARCH, "area": AREA, "level": LEVEL, "visible_only": BOOLEAN, "group_by_area": BOOLEAN, "order_by": "name"|"created_at"|"level"|"paper_count", "order_direction": "asc"|"desc", "page": PAGE, "limit": LIMIT})` — search, list, and filter research tasks, or set `group_by_area: true` for the complete visible top-level taxonomy without pagination (`pwc task list`). - `get_method({"method": METHOD})` — inspect one exact method with its area (`pwc method --name`). - `list_methods({"search": SEARCH, "area": AREA, "introduced_year": YEAR, "order_by": "name"|"full_name"|"introduced_year"|"created_at"|"paper_count", "order_direction": "asc"|"desc", "page": PAGE, "limit": LIMIT})` — search, list, and filter research methods (`pwc method list`). - `get_conference({"conference": CONFERENCE})` — inspect one exact conference (`pwc conference --name`). - `list_conferences({"year": YEAR})` — list conferences with imported papers (`pwc conference list`). - `get_organization({"organization": ORGANIZATION})` — inspect one exact research organization (`pwc organization --name`). - `list_organizations({"featured_only": BOOLEAN})` — list research organizations (`pwc organization list`). - `get_framework({"framework": FRAMEWORK})` — inspect one exact research framework (`pwc framework --name`). - `list_frameworks({"domain": DOMAIN, "category": CATEGORY, "platform": PLATFORM})` — list research frameworks (`pwc framework list`). - `get_benchmark({"benchmark": BENCHMARK, "page": PAGE, "limit": LIMIT, "is_open": BOOLEAN, "max_parameters": SIZE, "require_metrics": [METRIC], "minimum_metrics": {METRIC: VALUE}, "maximum_metrics": {METRIC: VALUE}, "sort_metric": "METRIC:asc|desc", "pareto": ["METRIC:higher", "METRIC:lower"]})` — inspect one paginated benchmark leaderboard with model-size, metric threshold, sort, and Pareto selection (`pwc benchmark --name`). `matched_count` reports rows that satisfied the filters before pagination. - `list_benchmarks({"search": SEARCH, "task": TASK, "include_descendants": BOOLEAN, "minimum_evaluations": COUNT, "is_open": BOOLEAN, "group_by_area": BOOLEAN, "area": AREA, "benchmarks_per_task": COUNT, "order_by": "trending"|"name"|"full_name"|"created_at"|"paper_count", "order_direction": "asc"|"desc", "page": PAGE, "limit": LIMIT})` — list and filter benchmarks (`pwc benchmark list`). With `task`, results are ranked by trend unless `order_by` is set; `group_by_area` or `area` returns top benchmarks under each visible task. All page numbers start at 1. `limit` is between 1 and 25 and defaults to the CLI page size capped at 25. Follow `next_page` when the user asks for more results than one response contains; do not infer that a missing item does not exist until the relevant pages have been checked. The MCP server does not expose the standalone CLI's paper editing, authentication, skill installation, or version commands, and `pwc paper read` is served as `read_paper` chunks rather than one document. Do not invent equivalent tools. Use the separate `pwc` CLI only when it is available and the user needs one of those capabilities. ## Research workflow 1. Use `list_benchmarks({"task": TASK})` to discover active benchmarks, then `get_benchmark({"benchmark": NAME})` to inspect a leaderboard. Add `max_parameters` when model size is part of the request and `sort_metric` or `minimum_metrics` when a specific metric matters. 2. Use `get_paper_info({"paper": PAPER})` to inspect promising results. Its response includes official-first code; use `get_paper_evaluations` to page through its benchmark results. 3. Use exact `list_papers` `authors`, `task`, `method`, `conference`, `framework`, and `organization` arguments for known identities or catalog associations. Combine them to require every association; do not substitute a keyword search. Add `search` for title or abstract topic terms. 4. Use `search_papers` for broader discovery, then `read_paper` for primary evidence. Follow every returned continuation cursor needed for the user's question. 5. Expand the literature with `get_related_papers` and use `get_paper_lineage` when model or method ancestry matters. Use `get_task`, `get_method`, `list_conferences`, `list_organizations`, and `list_frameworks` to orient within the taxonomy. 6. Preserve paper titles, identifiers, and URLs so claims remain traceable. ## Output and limits - Tool results use stable, versioned structured output with compact text fallbacks. Prefer structured fields over parsing the text fallback. - Search mode is deterministic: `hybrid` is the default, matching `pwc search`; `keyword` uses lexical retrieval alone and `semantic` uses dense retrieval alone. Both `hybrid` and `semantic` count toward the semantic search rate limit, so pass `mode: "keyword"` for exact terminology or when that limit is close. - Catalog-filtered paper lists fail closed unless the server confirms every requested filter; never treat results from an older server as filtered. Parameter-filtered leaderboards fail closed unless the server confirms parameter-filter support and every returned model satisfies the limit. - `read_paper` returns at most one 64 KiB chunk per call. A continuation stays pinned to the resolved paper and content version; if the paper changes, start reading again from the beginning. - The hosted service limits each client to 60 total requests and 10 semantic or hybrid searches per minute, with at most four concurrent requests. Respect retry metadata instead of trying to work around limits. - The tools contain no authentication, catalog mutation, ingestion, publication, image, embedding, CRON, or infrastructure-maintenance operations.