Search Pilla

Search pages and blog articles, or ask Pilla.

Developers

Pilla MCP server and API

Connect an approved AI client or integration to Pilla. The MCP server exposes role-scoped tools for operational workflows while the REST API provides versioned HTTP endpoints.

Connect through MCP

OAuth-capable clients only need the server URL. Pilla advertises its authorization server through RFC 9728 protected-resource metadata. Deliberate API integrations can instead send a Pilla API key as a bearer token.

https://yourpilla.com/api/mcp
Authorization: Bearer pk_live_...

Build against the REST API

The current stable base URL is https://yourpilla.com/api/v1. Most REST endpoints use a Pilla API key as a bearer token. The API-key management endpoints use the signed-in Pilla web session because they create and revoke credentials.

Send a unique Idempotency-Key with POST, PATCH and DELETE requests. Reusing it for the exact same request safely replays the first response for 24 hours. Reusing it for different request data returns 409.

Backward-compatible additions stay in v1. A breaking contract uses a new versioned base path. Deprecated operations will be marked in OpenAPI and carry Deprecation and Sunset response headers before removal.

When to use Pilla

  • Show me overdue workflows and the teams responsible for them
  • Summarise the evidence recorded in this workflow run
  • Find a workflow template for a recurring operational process
  • Show recent workflow activity for my teams

Available domains

  • workflow management
  • workflow runs
  • workflow evidence
  • teams
  • team communication
  • activity log
  • workflow templates

Permissions and safety

API keys linked to a user inherit that user's role and team access. Account-level keys are available to administrators and carry account-level access.

Tool descriptions and annotations identify read-only, destructive, open-world and idempotent behaviour. Clients should show the exact action and obtain confirmation before consequential writes.

Pilla is ai work management for deskless teams. It does not provide shift scheduling, payroll, HR management or leaderboards.

Pilla also registers a small set of public, read-only WebMCP tools as a progressive enhancement for compatible browser agents. WebMCP is experimental and does not replace the authenticated MCP server.

Machine-readable resources