v0.3.0 — optional MCP server

Optional Model Context Protocol (MCP) server. Exposes paper / code lookup as tools to Claude Desktop, Cursor, Continue, Cline, Zed, and any other MCP-compatible agent. Read-only, no auth.

Install

pip install 'codeofpaper[mcp]'
# or
uv tool install 'codeofpaper[mcp]'

This adds a codeofpaper-mcp console script that speaks MCP over stdio.

Wire into Claude Desktop

{
  "mcpServers": {
    "codeofpaper": {
      "command": "codeofpaper-mcp"
    }
  }
}

Tools

Tool	Purpose
paper_lookup(paper_id_or_url)	Paper metadata + confident-tier repos
code_for_paper(paper_id_or_url, limit, include_possible)	Ranked GitHub repos implementing a paper
search_papers(query, limit, year, venue, has_code)	Free-text search with filters

All tools are read-only, return plain JSON, and surface API errors as {"error": "...", "status": N} rather than throwing — agents always get structured output.

What didn't change

The base codeofpaper CLI install is unchanged — no new required deps, no behaviour changes to existing commands. MCP support is gated behind the [mcp] extra.

See CHANGELOG.md for details.