Corvevo MCP server
Connect any MCP client (Claude Desktop, Claude Code, Cursor) to Corvevo and drive it in plain English: upload a drawing set, run the pipeline, check clashes, pull a cost estimate, export IFC/BCF/GLB.
The server is a thin HTTP proxy over the Corvevo FastAPI backend. No business logic lives here.
Remote endpoint (no install)
The backend serves the same tool set over streamable HTTP at /mcp.
claude.ai (web/mobile): add a custom connector with the URL https://corvevov1-production.up.railway.app/mcp. No token to paste — the endpoint speaks OAuth 2.1 (PKCE, dynamic client registration), and claude.ai walks the user through Corvevo sign-in and consent in the browser.
Claude Code: one command connects with a personal API token:
claude mcp add --transport http corvevo https://corvevov1-production.up.railway.app/mcp --header "Authorization: Bearer cpat_..."
Mint the token in Settings → Connect your AI. Requests are rate-limited to 120/minute per token; a read-scoped token can query but not run pipelines or mutate. The stdio install below remains useful for local backends and for export tools that write files onto your machine — remote export tools write inside the server container instead.
Install
From PyPI:
pip install corvevo-mcp
or run without installing:
uvx corvevo-mcp
From source:
cd mcp_server
pip install -e .
Configure
Environment variables:
| Variable | Default | Purpose |
|---|---|---|
CORVEVO_API_URL |
http://localhost:8000 |
Backend base URL (production: https://corvevov1-production.up.railway.app) |
CORVEVO_API_TOKEN |
— | A personal API token (cpat_…) minted in Settings → Connect your AI. Production requires this (or credentials); omit only against a local backend with AUTH_REQUIRED=false |
CORVEVO_EMAIL / CORVEVO_PASSWORD |
— | Alternative to a token: the server logs in, caches the JWT, and re-logs-in when it expires |
CORVEVO_DOWNLOAD_DIR |
CWD | Where export tools (GLB/IFC/BCF/XLSX) write files |
Claude Desktop / Claude Code config entry (Settings → Connect your AI generates this with your token filled in):
{
"mcpServers": {
"corvevo": {
"command": "corvevo-mcp",
"env": {
"CORVEVO_API_URL": "https://corvevov1-production.up.railway.app",
"CORVEVO_API_TOKEN": "cpat_..."
}
}
}
}
Tools
Projects and pipeline: list_projects, get_project, create_project, upload_file, run_pipeline, pipeline_status, project_summary.
Clash detection: run_clash_detection, get_clashes, clash_summary.
Coordination (IFC/BCF): coordination_capabilities, ingest_ifc, list_ifc_models, run_ifc_clashes, run_advanced_coordination, export_bcf, import_bcf.
3D model: build_building_model, building_model_status, export_glb, export_ifc.
Cost: get_cost_estimate, run_cost_estimate, export_cost_xlsx.
Compliance: run_compliance_check, get_compliance_results.
Chat: ask_corvevo — the agentic project chat, answer plus source citations.
Claude Skill
skills/corvevo-coordination/ packages the find-fix-verify loop as a Claude Skill: judgment rules (slab penetrations are sleeves, not reroutes), the Bonsai fix snippet with unit conversion, GUID-stability rules, and the fire-once/poll pattern for long runs. Install by copying the folder:
cp -r skills/corvevo-coordination ~/.claude/skills/
Notes
- List tools cap output at 50 records so a single call cannot flood the client model's context. Use the summary tools for totals.
run_pipelinefires once; pollpipeline_statusinstead of re-firing.- IFC solid clash requires
ifcopenshellon the backend;coordination_capabilitiesreports availability and the reason when missing.
Metadata
Release files for corvevo-mcp 0.2.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| corvevo_mcp-0.2.0.tar.gz | 12.0 kB | Without provenance | Details for corvevo_mcp-0.2.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| corvevo_mcp-0.2.0-py3-none-any.whl | Python 3 | none | any | Details for corvevo_mcp-0.2.0-py3-none-any.whl |
Total release size: 21.4 kB
Release files / corvevo_mcp-0.2.0.tar.gz
| Download URL | corvevo_mcp-0.2.0.tar.gz |
|---|---|
| Size | 12.0 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
6a28f79a995c4bf1c65f9e291810f772e08df5e5d8b56865e836cadd5c23f934
|
|
BLAKE2b-256 checksum How to use checksums |
78a7dc2024834252b551b40d926a502865c0a28377553b31df1cd0b7ea2e79ee
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.11.15
|
Release files / corvevo_mcp-0.2.0-py3-none-any.whl
| Download URL | corvevo_mcp-0.2.0-py3-none-any.whl |
|---|---|
| Size | 9.4 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
ba438939901ab54ece1ff726cb5587b28c7963c8b8837b55f11b2462bc4cbd6f
|
|
BLAKE2b-256 checksum How to use checksums |
2a4589e56b41f0c38a45f5a21eacc06b5310548bf17288ce092de00d3b396c31
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.11.15
|
Security for corvevo-mcp 0.2.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.