[Cotlet](https://cotlet.dev/index.md) · [Integrations](https://cotlet.dev/integrations.md) · [How it works](https://cotlet.dev/how-it-works.md) · [Security](https://cotlet.dev/security.md) · [For developers](https://cotlet.dev/for-developers.md) · [For automation agencies](https://cotlet.dev/for-agencies.md) · [Blog](https://cotlet.dev/blog.md) · [API docs](https://cotlet.dev/docs.md) · [Help center](https://cotlet.dev/help.md) · [Changelog](https://cotlet.dev/changelog.md) · [Contact](https://cotlet.dev/contact.md) · [Pricing](https://cotlet.dev/pricing.md) · [Sign up](https://cotlet.dev/signup)

# Ontraccr API and MCP server: Let your AI agent clear the approvals and plan the crews.

> Ontraccr publishes no public API documentation. Its Zapier app lists one trigger, Card Moved, and one action, Create a Board Card. No Ontraccr MCP server and no official ChatGPT or Claude connector was found.

Ontraccr has no public API documentation, and its Zapier app has one trigger and one action (checked 17 Nov 2026). Cotlet runs a hosted Ontraccr MCP server with 40 tools that ChatGPT and Claude use in your own Ontraccr account. Approvals, shifts and anything that reaches a client wait for your OK.

- Free 7-day trial, no card
- Unofficial, not affiliated with Ontraccr
- Page: https://cotlet.dev/integrations/ontraccr-api-mcp-server

> Cotlet is an independent service. It is not affiliated with, endorsed by or sponsored by Ontraccr. Ontraccr is a trademark of its owner. If Ontraccr's own integrations cover what you need, use them first.

## What can your AI agent do in Ontraccr?

- Review and approve Team Cards
- Clear forms waiting for your approval
- Draft field shifts from the Gantt
- Check hours used against the budget
- Send a change order for signature
- Move a job card and assign the follow-up

## Does Ontraccr have an MCP server or an API?

- Ontraccr's Help Center documents its own QuickBooks Online, Sage 100 Contractor, Stripe, Gmail and DocuSign integrations.
- Its integrations page lists technology, service and industry partners, not a developer API.
- Zapier offers its own MCP route for that one Ontraccr action; it is Zapier's product, not Ontraccr's.

| What you need | Ontraccr on Zapier | By hand | Cotlet |
|---|---|---|---|
| Create or move board cards | Create a card, react to a move | In the board | Create, move, add tasks |
| Approve forms and time cards | Not in the app | One by one | Listed, then approved after your OK |
| Shifts, budgets and equipment | Not in the app | One screen at a time | 40 tools |
| Ask ChatGPT or Claude to do the work | Through Zapier MCP, one action | Copy and paste | Hosted MCP server |

Checked 17 Nov 2026. Sources: [Ontraccr on Zapier](https://zapier.com/apps/ontraccr/integrations), [Ontraccr integrations](https://www.ontraccr.com/integrations), [Ontraccr Help Center](https://help.ontraccr.com/en), [Help: Reviewing and approving time cards](https://help.ontraccr.com/en/article/reviewing-approving-time-cards-in-ontraccr), [Help: Forms pending your approval](https://help.ontraccr.com/en/article/red-dot-indicator-forms-pending-your-approval), [Help: Creating shifts in the Field Schedule](https://help.ontraccr.com/en/article/creating-shifts-in-the-field-schedule), [Help: Project budget tracking](https://help.ontraccr.com/en/article/managing-and-viewing-project-budget-tracking-including-subcontract-budgets), [Help: Project status report](https://help.ontraccr.com/en/article/project-status-report), [Help: Collect External Signature block](https://help.ontraccr.com/en/article/collect-external-signature-block-send-forms-for-docusign-style-external-sign-off), [Help: Collect Payment block](https://help.ontraccr.com/en/article/collect-payment-block-send-stripe-links-to-customers-and-link-payment-to-form-workflows), [Help: Creating cards in boards](https://help.ontraccr.com/en/article/creating-cards-in-ontraccr-boards), [Help: Checking equipment in and out](https://help.ontraccr.com/en/article/checking-in-out-equipment)

## How does the Ontraccr MCP server work?

1. **Sign in to Ontraccr.** Once, in a browser we host for you.
2. **Connect your AI agent.** One address in its settings.
3. **Hand it the approvals.** Review Team Cards, then approve them.

Your agent works in your own signed-in Cloud Browser. Approvals, shifts and anything that reaches a client or a crew wait for your OK.

## How to connect Ontraccr to your AI agent

1. **Sign in to Ontraccr in a Cloud Browser.** Open app.ontraccr.com/login in your Cotlet Cloud Browser and log in with your own Ontraccr user.
2. **Add the Cotlet address.** Enter https://cotlet.dev/mcp/v1 as the MCP server or connector URL in your agent.
3. **Let the agent in.** Chat apps open a Cotlet sign-in page. Editors, n8n and scripts send an API key made in the console.

One connector at `https://cotlet.dev/mcp/v1` carries Ontraccr and every other app you enable. If you switch Ontraccr on later, refresh the connector and its 40 tools load.

ChatGPT:

```
Settings > Apps & Connectors > Create
MCP server URL: https://cotlet.dev/mcp/v1/connect
Authentication: OAuth
```

Claude:

```
Settings > Connectors > Add custom connector
URL: https://cotlet.dev/mcp/v1/connect

Claude Code:
claude mcp add --transport http cotlet \
  https://cotlet.dev/mcp/v1 \
  --header "Authorization: Bearer $COTLET_API_KEY"
```

Cursor:

```
// ~/.cursor/mcp.json
{
  "mcpServers": {
    "cotlet": {
      "url": "https://cotlet.dev/mcp/v1",
      "headers": { "Authorization": "Bearer ${env:COTLET_API_KEY}" }
    }
  }
}
```

Codex:

```
# ~/.codex/config.toml
[mcp_servers.cotlet]
url = "https://cotlet.dev/mcp/v1"
bearer_token_env_var = "COTLET_API_KEY"
```

n8n:

```
MCP Client Tool (inside an AI Agent)
Transport: HTTP Streamable
URL: https://cotlet.dev/mcp/v1
Auth: Bearer, <your key>
Tool: ontraccr_read
```

## All 40 Ontraccr MCP tools

One tool per workflow in the Ontraccr Help Center. Reports and searches only read; on tools with an `action`, `list` and `get` read and the rest write after your OK.

### Time cards, shifts and teams

Manual and team time entry, Team Cards approval, the Employee Payroll report, Field Schedule shifts and the teams that decide who approves whom.

- **Approve time cards** (`approve_time_cards`, write, asks first): Read Team Cards, then approve or reject time, with a note.
- **Enter time** (`enter_time`, write, asks first): Enter time after the fact for yourself or, as a foreman, for a team.
- **Run the payroll report** (`run_payroll_report`, read): Run the Employee Payroll report for a pay period.
- **Schedule field shifts** (`schedule_shifts`, write, asks first): Read the Field Schedule or create a shift, published or as a draft.
- **Manage teams** (`manage_teams`, write, asks first): List teams or create one with supervisors, members, projects and equipment.

### Forms and their workflows

Templates, submissions, approvals and the workflow blocks that launch linked forms, collect signatures through DocuSign or send Stripe payment links.

- **Approve forms** (`approve_forms`, write, asks first): List forms waiting for your approval, then approve or reject one.
- **Submit forms** (`submit_form`, write, asks first): Fill and submit a form from the Manual tab, a board card, a task or equipment.
- **Create form templates** (`manage_form_templates`, write, asks first): List form templates or create one from scratch or from an Ontraccr template.
- **Set form workflows** (`manage_form_workflows`, write, asks first): Read a form's workflow or add a Form Trigger block to it.
- **Request external signatures** (`add_signature_step`, write, asks first): Add a Collect External Signature step to a form's workflow, with signers in order.
- **Request customer payments** (`add_payment_step`, write, asks first): Add a Collect Payment step to a form's workflow, or read the payment status of a submission.
- **Publish external forms** (`publish_external_form`, write, asks first): Turn on External Form for a template and get its public link and QR code.
- **Export form reports** (`export_form_report`, read): Run a Custom Form Export: chosen columns from one form, filtered by date or division.

### Boards, cards and tasks

Boards and card designs, cards moving across statuses, status workflows, card tasks, your own My Tasks list and Advanced Search.

- **Create and move cards** (`manage_cards`, write, asks first): List a board's cards, create a card or move it to another status.
- **Assign card tasks** (`manage_card_tasks`, write, asks first): Read the Tasks tab of a card or add a task to it.
- **Complete my tasks** (`manage_my_tasks`, write, asks first): List the tasks assigned to you across boards, or mark one done.
- **Create boards** (`manage_boards`, write, asks first): List boards or create one with its statuses, card design and division.
- **Design board cards** (`manage_card_designs`, write, asks first): List card designs or create one with its fields and sections.
- **Set board workflows** (`manage_board_workflows`, write, asks first): List a board's workflows or add one, such as copy a card on a status.
- **Search boards and forms** (`search_records`, read): Run an Advanced Search across boards or forms with field filters.
- **Build dashboards** (`manage_dashboards`, write, asks first): Read a dashboard's widgets, create a dashboard or add a widget.

### Projects, budgets and contracts

Projects, cost codes, the Budget Tracking tab, the Project Status report, the Contract tab with change orders, and the project Gantt.

- **Create projects** (`manage_projects`, write, asks first): List or read projects, or create one through the Add Project steps.
- **View project budgets** (`view_project_budget`, read): Read the Budget Tracking tab of a project, with its cost code breakdown.
- **Run the project status report** (`run_project_status_report`, read): Compare estimated and actual labor hours per phase and cost code.
- **Set up project contracts** (`manage_project_contract`, write, asks first): Read or change a project's Contract tab: schedule of values, change orders, holdback.
- **Create cost codes** (`manage_cost_codes`, write, asks first): List cost codes or create one, globally or inside a project.
- **Build Gantt schedules** (`manage_gantt`, write, asks first): Read a project's Gantt tab, add a task or import a Microsoft schedule file.

### Customers and buckets

Customers under Contacts, Client Portal broadcasts and the custom databases Ontraccr calls buckets.

- **Add customers** (`manage_customers`, write, asks first): List customers under Contacts or add one with its contact fields.
- **Message client portal customers** (`broadcast_client_message`, write, asks first): Send a message to all Client Portal users or to chosen customers.
- **Create buckets** (`manage_buckets`, write, asks first): List buckets or create a custom database linked to customers, projects or equipment.

### Equipment, materials and inventory

Equipment records and check in or out, stock by location with low-stock thresholds, spreadsheet imports, assemblies and bulk labor cost changes.

- **Add equipment** (`manage_equipment`, write, asks first): List equipment or add a piece with name, division and status.
- **Check equipment in and out** (`check_equipment`, write, asks first): Check a piece of equipment in to a project or out again.
- **Track inventory** (`manage_inventory`, write, asks first): Read material quantities by location or set the low-stock threshold.
- **Import materials** (`import_materials`, write, asks first): Upload a material list from an XLS or XLSX spreadsheet.
- **Create assemblies** (`manage_assemblies`, write, asks first): List assemblies or bundle existing materials into one.
- **Bulk edit labor costs** (`bulk_edit_labor_costs`, write, asks first): Add to the labor cost or labor markup of selected materials or assemblies.

### Files and notes

Project folders, uploads, markups in the Advanced Viewer, file versions and the Notes tab with mentions.

- **Organize project files** (`manage_project_files`, write, asks first): List a project's folders and files, create a folder or upload a file.
- **Annotate files** (`annotate_file`, write, asks first): Add highlights, boxes or text to a drawing or document and save it.
- **List file versions** (`list_file_versions`, read): List the saved versions of a file and get a download link for one.
- **Add project notes** (`add_project_note`, write, asks first): Read a project's Notes tab or post a note with an optional file and mentions.

Inputs, REST path and example response of every tool: https://cotlet.dev/integrations/ontraccr-api-mcp-server#tools

## Who can see my Ontraccr session, and how do I revoke it?

- **What we store.** Your signed-in Ontraccr browser profile, AES-256-GCM encrypted, in Finland. Never your password.
- **What your agent gets.** The 40 Ontraccr tools. The session cookie stays in the Cloud Browser.
- **What the session sees.** The boards, forms, projects and time cards your Ontraccr role and divisions allow.
- **What no tool touches.** Users, roles and permissions, clock settings, and the QuickBooks Online, Sage 100 Contractor, Stripe, Gmail and DocuSign integrations.
- **If Ontraccr signs you out.** You log in again yourself, in the same Cloud Browser.
- **How to cut access.** Disable Ontraccr for agents, reset the browser, or change your Ontraccr password.

Cotlet never sees or stores your password. You log in yourself and the agent works only with the session left behind. Our site scores A+ on Qualys SSL Labs, securityheaders.com and Mozilla Observatory ([live results](https://cotlet.dev/security.md)).

## Approvals, undo and mistakes

1. **Pick the project and date.** manage_projects finds the job.
2. **Draft the time.** Users, start, end, break and cost code.
3. **Show you the hours.** Per person and in total, before saving.
4. **Save after your OK.** enter_time writes the team entry.

| Action | How to put it right |
|---|---|
| Card status, card task, draft shift | Call manage_cards, manage_card_tasks or schedule_shifts again with the right values |
| Time entry or approval | Edit the entry in Team Cards; payroll may already have read it |
| Published shift or project note with a mention | The crew was notified: tell them the change |
| Client Portal broadcast, signature or payment link | Already with the client: follow up with them |

All 34 write tools ask first: by default you confirm each call, and you can switch that off per tool. The 6 read tools, the reports, searches, budget and file versions, run at once.

MCP call:

```
{
  "name": "enter_time",
  "arguments": {
    "users": [
      "Crew member A",
      "Crew member B"
    ],
    "date": "2026-11-17",
    "start": "07:00",
    "end": "15:30",
    "break_minutes": 30,
    "project": "Maple Street watermain",
    "cost_code": "02-200"
  }
}
```

REST:

```
curl -X POST https://cotlet.dev/api/v1/ontraccr/time/enter \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"users":["Crew member A","Crew member B"],"date":"2026-11-17","start":"07:00","end":"15:30","break_minutes":30,"project":"Maple Street watermain","cost_code":"02-200"}'
```

Response:

```
{
  "date": "2026-11-17",
  "project": "Maple Street watermain",
  "cost_code": "02-200",
  "entries": [
    {
      "user": "Crew member A",
      "hours": 8
    },
    {
      "user": "Crew member B",
      "hours": 8
    }
  ],
  "total_hours": 16
}
```

The example logs 07:00 to 15:30 with a 30 minute break for two crew members on cost code 02-200: 8 hours each, 16 in all. A cron job or n8n flow can make the same call over REST at `/api/v1/ontraccr` with the same key and price, in JSON. Failed calls are free.

## How much does the Ontraccr MCP server cost?

**About $25 a month** for a contractor with 12 field staff on four projects, 4,280 credits. Your Ontraccr plan stays as it is.

| Job | Calls | Credits |
|---|---|---|
| Morning form approvals | 2 × 22 | 440 |
| Friday time card review and payroll report | 3 × 4 | 120 |
| Field shifts for next week | 12 × 4 | 480 |
| Board card moves and follow-up tasks | 2 × 40 | 800 |
| Weekly budget and status, four projects | 8 × 4 | 320 |
| Equipment check in and out | 1 × 40 | 400 |
| Daily site report submissions | 1 × 22 | 220 |
| Cloud Browser, 30 days |  | 1,500 |
| Total | 278 calls | 4,280 |

The smallest pack, 5,000 credits for $29, covers this month. More crews and projects mean more calls.

- Free 7-day trial, no card
- 10 credits per successful call, MCP or REST
- 50 credits a day for the Cloud Browser
- Your Ontraccr plan, role and divisions apply as they are

Credit packs are bought once, with no subscription. The month above is our assumption, not measured customer usage.

## Ontraccr MCP server: other ways to connect

| Option | What it does | Where it stops |
|---|---|---|
| Ontraccr on Zapier | Card Moved trigger and Create a Board Card action. | Nothing for forms, time cards, projects or equipment. |
| Zapier MCP | Puts that Ontraccr action in front of ChatGPT or Claude. | The same single action, run through your Zapier account. |
| Ontraccr's own integrations | QuickBooks Online, Sage 100 Contractor, Stripe, Gmail, DocuSign. | Accounting, payment and signature links, not a route for an AI agent. |
| Custom Form Exports | Chosen form fields as CSV or a dashboard widget. | A report you download, not actions. |

If creating a board card from another app is all you need, Ontraccr's Zapier app does it. Cotlet fits when ChatGPT, Claude or a script should work across time cards, forms, projects and equipment, from your own login, with nothing to host.

## Who runs Cotlet

Cotlet belongs to Take Group sp. z o.o., a software company registered in Poland, EU (VAT PL6342984273) and trading since 2019, founded by Bart Krawczyk (Co-founder, CTO) and Jake Slugocki (Co-founder, SEO, sales and marketing). Ask about the Ontraccr tools at contact@cotlet.dev.

## Ontraccr MCP server: questions

### How do I get access?

Sign up free at https://cotlet.dev/signup?app=ontraccr, turn on Ontraccr under Integrations in the console and log in at https://app.ontraccr.com/login in your Cloud Browser. Then connect your AI agent and ask it for this week's Team Cards. The trial needs no card.

### Does Ontraccr have an API?

Ontraccr publishes no public API documentation. Its integration with other tools runs through named integrations and a Zapier app with one trigger (Card Moved) and one action (Create a Board Card); no Ontraccr MCP server or official ChatGPT or Claude connector was found (checked 17 Nov 2026). Cotlet works in your own signed-in Ontraccr account instead.

### Do signatures and payment links work through Cotlet?

Only through the integrations you set up in Ontraccr. add_signature_step needs DocuSign connected in Settings > Integrations > DocuSign, and add_payment_step needs Stripe linked there. No Cotlet tool connects or changes those integrations.

### Does Cotlet touch QuickBooks or Sage 100 Contractor?

No. Ontraccr documents its own QuickBooks Online, Sage 100 Contractor, Stripe and Gmail integrations in its Help Center. You manage them in Ontraccr; no Cotlet tool changes them, or your users, roles and permissions.

### Which Ontraccr user should I sign in with?

A user whose role covers the work, usually a supervisor or admin. Approving time cards, Manual Entry for others and form approvals all follow that user's permissions and divisions.

### Is the MCP server different from the REST API?

Only in how it is called. Both carry the same 40 tools, inputs, answers, API key and price. Agents use MCP; scripts and n8n HTTP steps use REST.

### Is Cotlet affiliated with Ontraccr?

No. Cotlet is independent and not affiliated with Ontraccr.

---

Give your AI agents your signed-in browser.

**Product:** [Integrations](https://cotlet.dev/integrations.md) · [How it works](https://cotlet.dev/how-it-works.md) · [Pricing](https://cotlet.dev/pricing.md) · [Security](https://cotlet.dev/security.md)

**Resources:** [Blog](https://cotlet.dev/blog.md) · [API docs](https://cotlet.dev/docs.md) · [Help center](https://cotlet.dev/help.md) · [Changelog](https://cotlet.dev/changelog.md) · [GitHub](https://github.com/cotletdev/cotlet)

**Solutions:** [For developers](https://cotlet.dev/for-developers.md) · [For automation agencies](https://cotlet.dev/for-agencies.md)

**Company:** [About](https://cotlet.dev/about.md) · [AI info: company facts](https://cotlet.dev/ai-info.md) · [Contact](https://cotlet.dev/contact.md)

**Legal:** [Terms of service](https://cotlet.dev/terms) · [Privacy policy](https://cotlet.dev/privacy) · [Refund policy](https://cotlet.dev/refunds) · [Acceptable use](https://cotlet.dev/acceptable-use) · [Cookie policy](https://cotlet.dev/cookies) · [DPA](https://cotlet.dev/dpa) · [Subprocessors](https://cotlet.dev/subprocessors)

**Elsewhere:** [Status page](https://status.cotlet.dev) · [Cotlet on GitHub](https://github.com/cotletdev) · [Cotlet on X](https://x.com/cotletdev) · [Cotlet on LinkedIn](https://www.linkedin.com/company/cotletdev) · [Cotlet on Product Hunt](https://www.producthunt.com/products/cotlet) · [Cotlet on Crunchbase](https://www.crunchbase.com/organization/cotlet) · [Cotlet on SaaSHub](https://www.saashub.com/cotlet)

Cotlet.dev is built by Bart Krawczyk and Jake Slugocki, the founders of Take Group sp. z o.o., ul. Wincentego Janasa 4, 40-855 Katowice, Poland. KRS 0000871398, NIP 6342984273, VAT EU: PL6342984273. [About us](https://cotlet.dev/about.md)

Cotlet is an independent service. It is not affiliated with, endorsed by or sponsored by any of the products listed on this site. Product names are trademarks of their respective owners.
