MCP Reference
MCP Reference
Connect AI clients to Parcel data via the Model Context Protocol server at mcp.parcelengineering.com/mcp.
The Parcel MCP server is a remote Streamable HTTP server that exposes Parcel’s construction pipeline data to any MCP-compatible AI client (Claude, Cursor, Codex, and more).
Connect URL: https://mcp.parcelengineering.com/mcp
The /mcp path suffix is required. The bare domain (mcp.parcelengineering.com) returns a “no MCP server found” error.
Authentication
The server uses OAuth (no API keys). When you connect a client, the first tool call opens a Parcel login in your browser:
- Sign in with Continue with Microsoft or Continue with Google, or enter your work email and the 6-digit code we send.
- Pick a workspace.
Your session is then pinned to that workspace for usage attribution. Data tools read Parcel’s global datasets. Workspace tools read and write that workspace’s book, shared Views, and (because OAuth carries a user identity) personal Favorites.
Requirements
- A Parcel account that belongs to a workspace. Sign in with Microsoft, Google, or an email code. Email codes are only sent to existing accounts; Microsoft and Google sign-in work for any account, but without a workspace membership the connection cannot be completed.
- The Pro plan. Free and Starter workspaces receive a “requires the Pro plan” error.
What it exposes
The server exposes:
- Data tools — read-only
search_/get_for accounts, contacts, projects, and signals, plus field-discovery tools. - Workspace tools — search and get book records; upsert/delete accounts, projects, and contacts (including batches); signal subscriptions; members and invitations; workspace info and credits;
submit_data_feedback. - Views —
workspace_search_viewsandworkspace_manage_views, plus optionalview_idon the three workspace entity search tools for View-scoped execution.
See Available Tools for the full tool list and Workspace Views for definition grammar.
Reads that return rows cost 1 credit each. View definition, membership, Favorite, and other writes cost 0. See Credits.