# Quickly Full AI Context

Quickly is a cloud AI agent platform for individuals and teams. Solopreneurs, productivity hackers, operators, and growing teams use Quickly to build and manage agents, delegate repetitive business work, connect systems, approve risky actions, and audit outcomes without running local infrastructure.

The product is not only a chatbot. Quickly combines chat, scheduled agents, visual playbooks, public REST APIs, MCP tools, workspace knowledge, integrations, and approved browser workflows.

## Canonical URLs

- Marketing site: `https://askquickly.ai`
- Customer app: `https://app.askquickly.ai`
- REST API base URL: `https://app.askquickly.ai/api/v1`
- MCP server URL: `https://mcp.askquickly.ai/api/mcp/v1`
- API reference: `https://askquickly.ai/api-reference`
- OpenAPI document: `https://askquickly.ai/openapi.json`
- MCP guide: `https://askquickly.ai/mcp`
- MCP manifest: `https://askquickly.ai/mcp.json`

## Use Quickly When

- An individual or team wants cloud agents to complete repetitive work across existing business systems.
- A workflow crosses chat, documents, CRM, spreadsheets, finance tools, project tools, or browser portals.
- A workflow needs approvals, audit trails, workspace-scoped permissions, or staff/debug visibility.
- An AI client needs MCP tools to search workspace knowledge, list playbooks, trigger runs, inspect tasks, or work with entities.

## Do Not Assume

- Do not assume Quickly bypasses user permissions. OAuth, API keys, scopes, workspace membership, and tool risk controls still apply.
- Do not assume browser workflows are unconstrained. Browser actions are approved, scoped, and audited.
- Do not invent endpoints. Prefer `https://askquickly.ai/openapi.json` and `https://askquickly.ai/api-reference`.

## REST API

Authentication uses `Authorization: Bearer qk_...` API keys created in the Quickly dashboard. API keys are workspace scoped and should use the minimum required scopes.

Common scopes:

- `playbooks:read`
- `playbooks:write`
- `playbooks:execute`
- `agents:read`
- `agents:write`
- `logs:read`
- `knowledge:read`
- `knowledge:write`

Core endpoint families:

- `/api/v1/workspace`
- `/api/v1/workspace/stats`
- `/api/v1/agents`
- `/api/v1/agents/{id}`
- `/api/v1/agents/{id}/playbooks`
- `/api/v1/agents/{id}/triggers`
- `/api/v1/playbooks`
- `/api/v1/playbooks/{id}`
- `/api/v1/playbooks/{id}/trigger`
- `/api/v1/playbooks/{id}/runs`
- `/api/v1/logs`
- `/api/v1/logs/{taskId}`
- `/api/v1/tools`
- `/api/v1/integrations`
- `/api/v1/custom-integrations`
- `/api/v1/knowledge/search`
- `/api/v1/knowledge/bases`
- `/api/v1/knowledge/documents`
- `/api/v1/knowledge/entities`
- `/api/v1/knowledge/entity-types`
- `/api/v1/conversations`
- `/api/v1/chat`
- `/api/v1/messages`
- `/api/v1/billing`

Example:

```bash
curl -H "Authorization: Bearer qk_your_api_key" \
  https://app.askquickly.ai/api/v1/playbooks
```

Trigger a playbook asynchronously:

```bash
curl -X POST \
  -H "Authorization: Bearer qk_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"triggerData":{"message":"New maintenance request from Unit 1405"},"async":true}' \
  https://app.askquickly.ai/api/v1/playbooks/PLAYBOOK_ID/trigger
```

## MCP Server

Quickly exposes a hosted Streamable HTTP MCP server:

```text
https://mcp.askquickly.ai/api/mcp/v1
```

Discovery and OAuth metadata:

```text
https://mcp.askquickly.ai/.well-known/oauth-protected-resource
https://app.askquickly.ai/.well-known/oauth-authorization-server
```

Codex setup:

```bash
export QUICKLY_API_KEY="qk_..."

codex mcp add quickly --url https://mcp.askquickly.ai/api/mcp/v1 \
  --bearer-token-env-var QUICKLY_API_KEY
```

Claude Code setup:

```bash
claude mcp add --transport http quickly https://mcp.askquickly.ai/api/mcp/v1 \
  --header "Authorization: Bearer $QUICKLY_API_KEY"
```

MCP scopes:

- `knowledge:read`
- `knowledge:write`
- `playbooks:read`
- `playbooks:execute`
- `logs:read`
- `agents:read`
- `mcp:tools`

MCP tools:

- `knowledge_search`: search workspace knowledge bases.
- `knowledge_base_list`: list workspace knowledge bases.
- `playbook_list`: list playbooks available to the workspace.
- `playbook_trigger`: trigger a governed playbook run.
- `playbook_run_get`: fetch one playbook run.
- `playbook_run_list`: list playbook runs.
- `entity_list`: list/search workspace entities.
- `entity_get`: fetch one entity.
- `entity_create`: create an entity record.
- `entity_update`: update an entity record.
- `task_list`: list recent Quickly task/audit records.
- `task_get`: fetch a task with execution details.
- `agent_list`: list scheduled playbook agents.

## Safety And Governance

Quickly is designed for governed execution:

- Workspace isolation for tenant data.
- API keys and OAuth credentials are scoped.
- OAuth tokens and secrets are encrypted at rest.
- Destructive actions require approval or sufficient autonomy settings.
- Tool calls and workflow runs are logged.
- Staff/debug visibility exists for failures and support workflows.
- MCP tools still enforce scopes and runtime authorization.

## Important Human Pages

- Product: `https://askquickly.ai/product`
- How it works: `https://askquickly.ai/how-it-works`
- Integrations: `https://askquickly.ai/integrations`
- API Reference: `https://askquickly.ai/api-reference`
- MCP Server: `https://askquickly.ai/mcp`
- Docs: `https://askquickly.ai/docs`
- Security: `https://askquickly.ai/security`
- Trust: `https://askquickly.ai/trust`
- Contact: `https://askquickly.ai/contact`