---
title: ProxyAI developer documentation
description: MCP integration, Agent Tasks internals and built-in Helpdesk setup.
canonical: https://www.proxyai.app/docs
last-updated: 2026-10-19
---

> For the complete documentation index, see [llms.txt](https://www.proxyai.app/llms.txt). Request public content pages with `Accept: text/markdown`.

# ProxyAI developer documentation

Use these guides to connect an assistant, understand how Agent Tasks execute and configure the built-in Helpdesk.

## [ProxyAI MCP documentation](https://www.proxyai.app/docs/mcp)

Connect an MCP client, discover tools and scopes, and work with tickets and supported Agent Tasks.

## [How ProxyAI Agent Tasks work](https://www.proxyai.app/docs/agent-tasks)

Understand task instructions, compiled versions, tool permissions, triggers and run records.

## [Agent Tasks: execution and approvals](https://www.proxyai.app/docs/agent-tasks-execution)

Follow run states, understand test-mode exceptions, and review held actions safely.

## [Agent Tasks: schedules and triggers](https://www.proxyai.app/docs/agent-tasks-schedules)

Understand timezone-based schedules, activation, manual runs, events and overlapping work.

## [Agent Tasks: permissions and credentials](https://www.proxyai.app/docs/agent-tasks-permissions)

Understand tool grants, pinned resources, secret handling and customer-called task boundaries.

## [Set up the built-in Helpdesk](https://www.proxyai.app/docs/helpdesk-setup-wizard)

Connect your support mailbox, manage ticket housekeeping, and add a ticket form.

## API and authentication

Read [API discovery](https://www.proxyai.app/api), [OpenAPI](https://www.proxyai.app/openapi.json), [authentication](https://www.proxyai.app/auth.md), and [the public product API](https://www.proxyai.app/api/v1/products).

The product API accepts `limit` (1–100, default 50) and an optional `cursor` from the previous response. Follow `next_cursor` or the response's `Link: rel=next` until `next_cursor` is null. Prices are USD decimal strings; account purchases require separate authorization.

## Verified MCP listings

Find ProxyAI in the [official MCP Registry](https://registry.modelcontextprotocol.io/v0.1/servers/io.github.JC-lurker%2Fproxyai/versions/latest) and [Glama](https://glama.ai/mcp/connectors/app.proxyai/proxy-ai). Inspect the [public tool manifests](https://www.proxyai.app/.well-known/mcp/server-cards.json) for schemas and permissions.