Part3 Developers

Available Tools

Reference for the tools exposed by the Part3 MCP server.

Each tool calls a Part3 REST API endpoint as the signed-in user. Tool visibility depends on your role on the relevant org or project — if you can't see something in the web app, you can't see it through MCP either.

Your client discovers the live tool set automatically from the Part3 API — the tables below highlight the common ones, they're not an exhaustive list. New tools appear as the API adds them, with no client update. For the exact request shape of any tool, see the API Reference.

Your work (no org id needed)

These answer "show me my stuff" across every org and project you can access, in a single call — you don't need to know or pass an organization id. Start here for "what am I working on?" questions.

ToolDescription
client_me_projectsEvery project you're a member of, across all your orgs
client_me_organizationsEvery org you can reach — direct membership or via a project you're on
client_me_documentsDocuments across all your projects. Filter by status, format, filter.dueDate, and assignedToMe — e.g. "my overdue documents", "what's assigned to me", "who do I need to chase?"
client_me_preferencesYour own profile, notification preference, and MFA status

client_me_documents returns only the documents you're entitled to: all documents in projects where you're a Prime, and only your assigned / distributed / approver documents in projects where you're not.

Drill into a specific org or project

When you (or the assistant) already have an org/project id, these take it explicitly:

ToolDescriptionRequired Permission
projects_listList projects in a specific org (organizationId)project:read
documents_listList documents in a project, with filtersdocument:read
document_getFull document details with format-specific fieldsdocument:read
document_activity_listAudit trail — who did what, whendocument:read
project_getProject detail + health (doc counts, overdue, activity)project:read
organization_getOrg overview: projects, members, doc breakdownorganization:read
project_activity_listRecent project actions — document changes, status updatesproject:read
drawings_bundleBundle project drawings into a single PDF (15-min URL)document:read
email_investigateInvestigate email delivery and timeline for a recipientemail:read
client_organization_directory_listOrganization contacts and companies directoryorganization:directory:user:read
omnisearchCross-entity full-text search — see Omnisearch for the full surfaceproject:read

Super-duper-admin tools

ToolDescriptionRequired Role
organizations_listList all organizations on the platformsuperadmin

Access rules

  • Prime-only access gate — MCP itself is restricted to Project Primes and super-duper-admins. Non-Primes can't connect at all.
  • Per-tool permissions — once connected, each tool checks your role on the specific org or project being queried. The same checks the web app does.
  • Self-scoped by construction — the client_me_* tools return only your own memberships and the documents you're entitled to. There's no org id to supply and nothing to enumerate beyond your own access.
  • Super-duper-admin users see every tool, including the org-listing tool above, and bypass per-resource permission checks. The client_me_* tools still scope to the admin's own memberships — they're a "my work" view, not a platform-wide one.

On this page