# CheckFlow — how to use (mcp.ai)

Connect your CheckFlow account and use 10 tools for project management straight from your AI agent. Connect with your own API key. CheckFlow is a workflow and checklist platform for managing repeatable processes, tasks, templates, teams, data sets, and automation.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_checkflow?ms=1787295720000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `checkflow_create_tag`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/checkflow`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/checkflow/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/checkflow/create/tag` — Create a team tag by name, or return the existing same-name tag without creating a duplicate.
  - body: { name: string }
- `POST https://api.mcp.ai/api/checkflow/find/checklists` — Find checklist summaries for a template, optionally filtered by name, tag, or lifecycle status. Returns one page and a cursor for the next page.
  - body: { tag?: string, cursor?: string, status?: string, page_size?: integer, template_key: string, checklist_name?: string }
- `POST https://api.mcp.ai/api/checkflow/get/analytics` — Return checklist and task activity analytics for a date range.
  - body: { period_end_date?: string, period_start_date: string }
- `POST https://api.mcp.ai/api/checkflow/get/task/details` — Get one checklist task with its controls, comments, and assignees.
  - body: { task_key: string, checklist_id: integer }
- `POST https://api.mcp.ai/api/checkflow/get/team/directory` — Return active team members and groups, including each group's membership, optionally filtered by name.
  - body: { name_contains?: string }
- `POST https://api.mcp.ai/api/checkflow/list/checklist/details` — Return one page of full checklist instances, including tasks and controls, with a cursor for the next page.
  - body: { tag?: string, cursor?: string, status?: string, page_size?: integer, template_key: string, checklist_key?: string, checklist_name?: string }
- `POST https://api.mcp.ai/api/checkflow/list/tags` — List the tags available to the connected CheckFlow team.
- `POST https://api.mcp.ai/api/checkflow/list/template/tasks` — List the task keys and names defined by one checklist template.
  - body: { template_key: string }
- `POST https://api.mcp.ai/api/checkflow/list/templates` — List active checklist templates and their keys for creating or finding checklists.
- `POST https://api.mcp.ai/api/checkflow/list/webhook/subscriptions` — List webhook subscriptions, optionally filtered by source and event type.
  - body: { source?: string, event_type?: string }

## Example prompts
- "What can I do in CheckFlow?"
- "Show me a summary of my CheckFlow account"

## More
- Page: https://mcp.ai/checkflow
- Agent spec (llms.txt): https://mcp.ai/checkflow/llms.txt
- Postman collection: https://mcp.ai/checkflow/postman.json
