# Workestra

> Agent-first documentation for Workestra REST, MCP, tools, webhooks, and integration testing.

Canonical starting point: https://docs.workestra.app/docs/api
AI agent guide: https://docs.workestra.app/docs/api/agent-guide
Complete agent bundle: https://docs.workestra.app/llms-full.txt
Machine-readable JSON bundle: https://docs.workestra.app/api/help-docs/bundle?section=agent
REST API: https://platform.workestra.app/api/v1
Hosted MCP API: https://platform.workestra.app/api/mcp
OpenAPI publication status: https://docs.workestra.app/docs/api/openapi
Support: support@workestra.app

Security: Never ask a user to paste an API key into chat. Retrieve live MCP schemas before calls and stop rather than probing unlisted REST routes or guessing request fields.

## Agent integration documents

- [API Reference](https://docs.workestra.app/docs/api): Build and test integrations with the Workestra REST, MCP, and agent-trial APIs.
- [AI Agent Integration Guide](https://docs.workestra.app/docs/api/agent-guide): The canonical handoff document for an AI assistant connecting to Workestra.
- [Authentication](https://docs.workestra.app/docs/api/authentication): Create Workestra API keys and understand REST scopes and MCP permissions.
- [API Testing Guide](https://docs.workestra.app/docs/api/testing): Safe smoke tests for Workestra REST and hosted MCP endpoints.
- [Integration Recipes](https://docs.workestra.app/docs/api/recipes): Safe end-to-end recipes for common Workestra REST and MCP integrations.
- [API and MCP Troubleshooting](https://docs.workestra.app/docs/api/troubleshooting): Diagnose authentication, permissions, validation, rate limits, missing tools, webhooks, and transport failures.
- [Endpoints Overview](https://docs.workestra.app/docs/api/endpoints): Supported resource guides for the Workestra REST API.
- [Contacts API](https://docs.workestra.app/docs/api/endpoints/contacts): List and create CRM contacts.
- [Deals API](https://docs.workestra.app/docs/api/endpoints/deals): List, create, retrieve, update, and delete CRM deals.
- [Projects API](https://docs.workestra.app/docs/api/endpoints/projects): Manage projects and inspect their cycles and tasks.
- [Issues, Tasks, and Tickets API](https://docs.workestra.app/docs/api/endpoints/issues): Current compatibility API for project tasks and support tickets.
- [Public API Status](https://docs.workestra.app/docs/api/status): Supported Workestra REST paths, scopes, and current limitations.
- [API Webhooks](https://docs.workestra.app/docs/api/webhooks): Current outbound webhook delivery contract for Workestra modules.
- [Rate Limits and Quotas](https://docs.workestra.app/docs/api/rate-limits): Current enforced limits for Workestra REST and MCP requests.
- [Versions and Contract Changes](https://docs.workestra.app/docs/api/versioning): REST, MCP, tool-registry, and documentation version compatibility.
- [OpenAPI Reference](https://docs.workestra.app/docs/api/openapi): Generated specification for the supported Workestra REST contract.
- [Human-approved Agent Trials](https://docs.workestra.app/docs/api/agent-trials): Request an isolated Workestra evaluation for an AI agent without sharing an existing workspace.
- [MCP Server](https://docs.workestra.app/docs/integrations/mcp): Connect Codex, Claude, Cursor, VS Code, Windsurf, and other MCP clients to Workestra using the public workestra-mcp server.
- [Tool Discovery and Testing](https://docs.workestra.app/docs/integrations/mcp/tools): Retrieve the complete permission-aware Workestra tool catalog and test hosted MCP calls.
- [Zapier Integration](https://docs.workestra.app/docs/integrations/zapier): Availability and safe alternatives for connecting Workestra to Zapier.
- [API Keys](https://docs.workestra.app/docs/modules/support/api-keys): Create scoped, revocable credentials for the REST API, hosted MCP, and Support public API.
- [Support Developer API](https://docs.workestra.app/docs/modules/support/developer-api): Create and read support tickets, add replies, submit CSAT, and search the public knowledge base.
- [Support Outbound Webhooks](https://docs.workestra.app/docs/modules/support/webhooks): Queue and verify signed Support ticket-event deliveries.
- [Projects REST API](https://docs.workestra.app/docs/modules/projects/integrations/rest-api): Manage projects and project tasks through the Workestra v1 API.
- [Projects AI and MCP Tools](https://docs.workestra.app/docs/modules/projects/integrations/ai-chat): The 14 Projects tools available through Workestra AI and MCP.
- [Project Webhooks](https://docs.workestra.app/docs/modules/projects/integrations/webhooks): Current signed-delivery and event behavior for Projects webhooks.
- [AI Tools (Finance)](https://docs.workestra.app/docs/modules/finance/ai-tools): The 27 finance tools exposed to Workestra AI and MCP.