
Code of Paper
io.github.isagelswannPublished by GitHub account isagelswannv0.3.2Updated Oct 24, 2026
Find GitHub implementations of arXiv research papers — paper lookup, ranked code, search.
Overview
Code of Paper lets an assistant look up arXiv papers and find their GitHub implementations, with paper details, ranked code repositories and full-text search.
- What you can do
- Look up papers: fetch metadata and confident-tier implementation repos by arXiv ID or full URL.
- When to use it
- Use it when you need to go from an arXiv paper to its GitHub implementations, compare candidate repositories for one paper, or filter papers with code by topic, year or venue. Suited to literature reviews, picking a repo before reproducing results, and scripted workflows that want structured JSON.
- Requirements
- Runs locally over stdio via uvx from the PyPI package codeofpaper (Python 3.10 or newer). Connects to api.codeofpaper.com by default, overridable with the CODEOFPAPER_API_URL environment variable; anonymous use is limited to 60 requests per minute and needs no API key. Network access required.
Installation
In SourceWeft
- Open Code of Paper in the dashboard and add it to a workspace.
- Enable the server for the chats that should use its tools.
Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.
Other MCP clients
Follow the launch instructions in the repository.
README
Code of Paper CLI
Maintenance mode. This CLI and MCP server are not actively developed. They keep working as long as api.codeofpaper.com is up; issues may go unanswered.
Discover GitHub implementations of research papers — from the terminal.
Search 181k+ arXiv papers and find their code on GitHub. Works for humans and AI agents alike.
[PyPI] [Python 3.10+] [License: MIT]
Install
Or with pipx for isolated installs:
Requires Python 3.10+. No API key needed — works anonymously at 60 requests/minute.
Quick Start
Output Formats
Use -o / --output before the subcommand:
The shorthand -q is equivalent to -o quiet:
You can set a default format via config so you don't need -o every time:
Commands
Discovery
Browsing
Bulk Operations
Configuration
Command Details
search
Options: --limit, --offset, --sort (relevant, recent, has_code), --has-code, --category.
research
Multi-step orchestrated overview of a research topic:
batch
Process multiple queries or IDs from a file or stdin. Always outputs JSONL regardless of -o:
Supported commands: paper, search, code, similar, suggest.
Each line produces one JSON object:
Options: --delay (seconds between calls, default 0.5).
export
Paginated bulk export from trending, conference, or search:
Auto-paginates through results (100 per page, 0.5s delay). Options: --max (default 200), --has-code, --category, --days.
Agent Integration
The CLI is designed for AI agent consumption. Key features:
Stable Exit Codes
Agents can branch on exit codes without parsing error messages:
Machine-Readable Output
HTTP Cache
Responses are cached on disk for 30 minutes (~/.cache/codeofpaper/http/), so repeated calls are instant and free.
MCP Server (optional)
Code of Paper ships an optional Model Context Protocol server that exposes paper / code lookup as tools to any MCP-compatible agent — Claude Desktop, Cursor, Continue, Cline, Zed, etc.
Install with the mcp extra:
This adds a codeofpaper-mcp entry point that speaks MCP over stdio.
Wire into Claude Desktop
Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS), %APPDATA%\Claude\claude_desktop_config.json (Windows), or ~/.config/Claude/claude_desktop_config.json (Linux):
This pulls + runs the server on demand — no global install needed. If you've already pip install'd the package, you can replace the command with just "codeofpaper-mcp" and drop args.
Wire into Cursor / Continue / Cline
Most MCP clients accept the same shape:
Tools exposed
All tools are read-only, return plain JSON, and surface API errors as {"error": "...", "status": N} rather than throwing — agents get structured output either way.
Common Workflows
Core Discovery
Browsing & Monitoring
Composable Pipelines
Multi-Step Scripts
Configuration
Config is stored as JSON via platformdirs:
Fields:
No config file needed — everything works out of the box with sensible defaults.
Priority Chain
Options are resolved in this order (first wins):
- CLI flag (
--api-url,--api-key,--ca-bundle,-o) - Environment variable (
CODEOFPAPER_API_URL,CODEOFPAPER_API_KEY,CODEOFPAPER_CA_BUNDLE,CODEOFPAPER_OUTPUT,CODEOFPAPER_TIMEOUT) - Config file
- Built-in defaults
Corporate Proxies / Custom TLS Certificates
If you're behind a corporate proxy that performs TLS inspection (man-in-the-middle), you'll see an SSL error like:
To fix this, point the CLI at your corporate CA certificate bundle (PEM file). Three equivalent ways, in priority order:
Ask your IT department for the CA certificate file if you don't have it.
Tip: If you've already set
SSL_CERT_FILEfor other tools (pip, curl, etc.), httpx respects that variable automatically — no extra configuration needed.
Alias: cop
Both codeofpaper and cop are installed as entry points:
Note: If
copconflicts with another tool on your system, usecodeofpaperinstead.
Shell Completion
Install tab completion for your shell:
Supports bash, zsh, fish, and PowerShell. After installing, restart your shell or source the completion file.
Help
Links
- Website: https://codeofpaper.com
- API docs: https://api.codeofpaper.com/docs
- Agent discovery: https://codeofpaper.com/llms.txt
License
MIT
Source: README.md at commit f4d05fd
Tools
0Version history
1- v0.3.2LatestSep 16, 2026
Score
50% of the applicable checks met
How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.
- Reached in the last 30 days25 pts
Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.
- Auth declared10 pts
Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.
- Tools listed15 pts
Answer tools/list without a credential, or ship a package that starts in a sandbox without one.
- DescriptionRequired15 pts
- Logo10 pts
- Documentation15 pts
- License10 pts