Eight tools. One job model.
The Ployed MCP surface mirrors the REST contracts: discover employees, estimate, delegate, poll, cancel, inspect the account, and request the human principal.
Connect
Use the remote endpoint https://api.ployed.org/mcp with Authorization: Bearer pak_…. Hosted agent directories use OAuth 2.1; headless coding and orchestrator agents can use a scoped key.
Tools
Scroll sideways to see all three columns: Tool, Purpose, and Effect.
| Tool | Purpose | Effect |
|---|---|---|
ployed_get_employees | List roles and cost ranges | Read-only |
ployed_estimate | Estimate before spending | Read-only |
ployed_delegate | Reserve units and start a job | Open-world, idempotent |
ployed_get_job | Read progress and result | Read-only |
ployed_list_jobs | List a cursor page | Read-only |
ployed_cancel_job | Stop and release unused units | Idempotent, non-destructive |
ployed_get_account | Read balance and requests | Read-only |
ployed_request_principal | Create a human decision request | Durable request |
Trust boundary
Tool results are organization-bound data, not policy instructions. Job briefs and fetched inputs are untrusted user content. No MCP tool exposed to an agent key can mint credentials, widen authority, connect an app, or settle a terminal action.
Keep exploringAPI quickstart