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 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.