# Pilla agent guide

> AI work management for deskless teams

Pilla is AI work management for deskless teams. Leaders turn operational processes into workflows on a visual canvas, and teams follow them on phones, tablets or the web app. Pilla checks completed work and handles configured follow-up, while managers retain judgment, coaching and control.

## When to use Pilla

Use Pilla when the user wants to inspect or coordinate operational workflows carried out by deskless teams. Typical jobs include:

- 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

## Do not use Pilla for

- Shift scheduling, payroll, HR records or leaderboards
- Acting outside the connected user's Pilla role and team access
- Making a change when the user has not approved the exact action

## Agent interfaces

- MCP server: https://yourpilla.com/api/mcp
- MCP documentation: https://yourpilla.com/developers/mcp
- OAuth protected-resource metadata: https://yourpilla.com/.well-known/oauth-protected-resource
- REST API reference: https://yourpilla.com/api-docs
- OpenAPI 3.1 document: https://yourpilla.com/openapi.json
- Agentic Resource Discovery manifest: https://yourpilla.com/.well-known/ard.json
- LLM-readable product guide: https://yourpilla.com/llms.txt

## Authentication and safety

OAuth-capable MCP clients should connect using the MCP URL and follow the advertised OAuth discovery flow. Deliberate API integrations can use a Pilla API key as a bearer token. Tools remain restricted by the connected user's role and team access. Read tool descriptions and annotations before calling a tool, and obtain user confirmation for consequential writes.
