precis-mcp
MCP research collaborator that reads papers and patents, cites passages, writes drafts, and designs and simulates.
Tested on Linux
Use it
Linux x86_64
You need first
- Runtimes:
Python 3.13,Python 3.12–3.13 - System packages:
PostgreSQL with the pgvector extension - Keys or accounts: PERPLEXITY_API_KEY, WOLFRAM_APP_ID, EPO_OPS_CLIENT_KEY
Install pinned precis-mcp 8.35.1 via uv tool
uv tool install --force --python 3.13 'precis-mcp==8.35.1'Downgrade mcp to <2 to fix ModuleNotFoundError for mcp.server.fastmcp
uv pip install --python "$HOME"/.local/share/uv/tools/precis-mcp/bin/python 'mcp<2'
Where the README and reality differ
- README: uv tool install --python 3.13 'precis-mcp[all]' works
What worked: Current PyPI pulls mcp 2.3.0 which renames FastMCP; server crashes with ModuleNotFoundError: No module named 'mcp.server.fastmcp'; need to pin mcp<2 via uv pip install 'mcp<2' in tool env
Verified in pickfit: the commands exactly as its sandbox ran them
For the record only: they name the sandbox's home, /home/sbx.
uv tool install --force --python 3.13 'precis-mcp==8.35.1'uv pip install --python /home/sbx/.local/share/uv/tools/precis-mcp/bin/python 'mcp<2'precis --helpCheck that it works
precis --helpThe output should contain “serve”.
Add it to your agent
claude mcp add precis-mcp -e PRECIS_DATABASE_URL='<PRECIS_DATABASE_URL>' -- precis serveJSON for Claude Desktop, Cursor and other clients
{
"mcpServers": {
"precis-mcp": {
"command": "precis",
"args": [
"serve"
],
"env": {
"PRECIS_DATABASE_URL": "<PRECIS_DATABASE_URL>"
}
}
}
}You fill in
PRECIS_DATABASE_URL: Postgres DSN (required)
Ask the user for PRECIS_DATABASE_URL; pickfit never had a value, so these are placeholders.
Add precis-mcp as a server in your MCP client; it then offers the tools get, search, put, edit, delete, tag, link and more.
What it does
- Read papers and patents with citationsNot tested
- Write paper and report draftsNot tested
- Design and simulate proposed designsNot tested
- Manage todos, quests and memoryNot tested
How far pickfit got
Linux x86_64
- Installs
- Connects
- 0 of 4 features work
- Works offline
Good for
- search papers and patents with paragraph-level citations
- write paper and patent drafts and export to LaTeX, PDF and Word
- design atomistic structures, CAD assemblies and PCBs
- query cached web, Wolfram, YouTube and Perplexity
How pickfit tested it
Each run starts from a clean machine and follows the steps above. How pickfit verifies
Linux x86_64
An MCP client called one of its tools
- Replayed from scratch
- Works offline
- Checked on 31 Oct 2026
- Version 8.35.1
An MCP client handshake over stdio listed 8 tools, and a call to get returned a result.
Differences the test machine hit
- README: precis serve requires PRECIS_DATABASE_URL and Postgres with pgvector
In the test: For smoke test without DB set PRECIS_SCHEMA_GATE=off and PRECIS_EMBEDDER=mock to allow server to boot with only calc kind live