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

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

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.

Ontraccr Cloud Browser

40 tools Read and write

Field and office work

What can your AI agent do in Ontraccr? The office side of running crews, forms and projects.

  • 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

Zapier only, no MCP

Does Ontraccr have an MCP server or an API? The official Ontraccr routes, checked 17 November 2026.

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'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.
Ontraccr's Zapier app, working by hand and Cotlet compared
What you need Ontraccr on ZapierBy handCotlet
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 · Ontraccr integrations · Ontraccr Help Center · Help: Reviewing and approving time cards · Help: Forms pending your approval · Help: Creating shifts in the Field Schedule · Help: Project budget tracking · Help: Project status report · Help: Collect External Signature block · Help: Collect Payment block · Help: Creating cards in boards · Help: Checking equipment in and out

Set up once

How does the Ontraccr MCP server work? The Ontraccr MCP server by Cotlet: your agent works in your own Ontraccr account.

  1. 1Sign in to Ontraccr

    Once, in a browser we host for you.

  2. 2Connect your AI agent

    One address in its settings.

  3. 3Hand 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. Who can see your session

Any MCP client

How to connect Ontraccr to your AI agent

  1. 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. 2

    Add the Cotlet address. Enter https://cotlet.dev/mcp/v1 as the MCP server or connector URL in your agent.

  3. 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
6 read, 34 write

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 teams5

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 Read Team Cards, then approve or reject time, with a note. writeAsks first

    `list` shows submitted, approved and geofence-breached entries for the users you approve. Approved time goes to payroll. By default you confirm each call; you can switch that off for this tool.

    MCP callontraccr_write → approve_time_cards

    REST endpointPOST https://cotlet.dev/api/v1/ontraccr/time-cards/approve

    Parameters

    Parameters: approve_time_cards
    NameTypeDescription
    action string required string One of `list`, `approve`, `reject`. `list` and `get` only read.
    user string string Whose card.
    period string string Week or dates.
    note string string Optional note.

    Example input

    {
      "action": "action"
    }

    Example response

    {
      "cards": [
        {
          "user": "Crew member C",
          "hours": 45,
          "status": "Submitted"
        },
        {
          "user": "Crew member A",
          "hours": 42,
          "status": "Submitted"
        }
      ]
    }
  • enter_time Enter time after the fact for yourself or, as a foreman, for a team. writeAsks first

    Manual Entry must be enabled in clock settings and your role must allow it. Hours feed payroll, so entries wait for your OK. By default you confirm each call; you can switch that off for this tool.

    MCP callontraccr_write → enter_time

    REST endpointPOST https://cotlet.dev/api/v1/ontraccr/time/enter

    Parameters

    Parameters: enter_time
    NameTypeDescription
    users array required array Team entry: several users.
    date string required string ISO date.
    start string string Start time.
    end string string End time.
    break_minutes number number Break.
    project string string Project.
    cost_code string string Cost code.

    Example input

    {
      "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"
    }

    Example 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
        }
      ]
    }
  • run_payroll_report Run the Employee Payroll report for a pay period. read

    Hours by employee, project, date, work type and cost code, rounded by your company setting or actual. It only reads; paying people stays in your payroll system.

    MCP callontraccr_read → run_payroll_report

    REST endpointGET https://cotlet.dev/api/v1/ontraccr/payroll-reports/run

    Parameters

    Parameters: run_payroll_report
    NameTypeDescription
    period string required string A preset such as `this_week`, `last_7_days`, or `custom`.
    from string string ISO date, for `custom`.
    to string string ISO date, for `custom`.
    rounded boolean boolean True for rounded hours, false for actual.

    Example input

    {
      "period": "period"
    }

    Example response

    {
      "period": "this_week",
      "employees": [
        {
          "employee": "Crew member A",
          "hours": 45
        },
        {
          "employee": "Crew member B",
          "hours": 42
        }
      ]
    }
  • schedule_shifts Read the Field Schedule or create a shift, published or as a draft. writeAsks first

    A published shift reaches the crew. Save as draft to hold it for later assignment. By default you confirm each call; you can switch that off for this tool.

    MCP callontraccr_write → schedule_shifts

    REST endpointPOST https://cotlet.dev/api/v1/ontraccr/shifts/schedule

    Parameters

    Parameters: schedule_shifts
    NameTypeDescription
    action string required string One of `list`, `create`. `list` and `get` only read.
    users array array Who works it.
    start string string ISO date and time.
    end string string ISO date and time.
    project string string Project.
    draft boolean boolean Save as draft instead of publishing.

    Example input

    {
      "action": "action"
    }

    Example response

    {
      "shift": "Pipe crew",
      "users": [
        "Crew member A",
        "Crew member B"
      ],
      "start": "2026-11-19T07:00",
      "project": "Maple Street watermain",
      "draft": false
    }
  • manage_teams List teams or create one with supervisors, members, projects and equipment. writeAsks first

    Teams decide who approves whose time, so changes wait for your OK. By default you confirm each call; you can switch that off for this tool.

    MCP callontraccr_write → manage_teams

    REST endpointPOST https://cotlet.dev/api/v1/ontraccr/teams/manage

    Parameters

    Parameters: manage_teams
    NameTypeDescription
    action string required string One of `list`, `create`, `update`. `list` and `get` only read.
    team string string Team name.
    supervisors array array Users who can approve time cards.
    members array array Members.
    projects array array Projects.

    Example input

    {
      "action": "action"
    }

    Example response

    {
      "team": "Pipe crew",
      "supervisors": [
        "Site lead"
      ],
      "members": 5,
      "saved": true
    }

Forms and their workflows8

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

  • approve_forms List forms waiting for your approval, then approve or reject one. writeAsks first

    `list` returns the forms where you are the approver, the ones Ontraccr marks with a red dot. An approval moves the form on in its workflow. By default you confirm each call; you can switch that off for this tool.

    MCP callontraccr_write → approve_forms

    REST endpointPOST https://cotlet.dev/api/v1/ontraccr/forms/approve

    Parameters

    Parameters: approve_forms
    NameTypeDescription
    action string required string One of `list`, `approve`, `reject`. `list` and `get` only read.
    form string string Form number, for `approve` and `reject`.
    note string string Optional note.

    Example input

    {
      "action": "action"
    }

    Example response

    {
      "pending": [
        {
          "form": "Change Order",
          "number": "CO-0031",
          "project": "Maple Street watermain",
          "submitted_by": "Site lead"
        }
      ]
    }
  • submit_form Fill and submit a form from the Manual tab, a board card, a task or equipment. writeAsks first

    The form must allow a manual trigger. Submitting starts its workflow, which can send it for approval or to other people. By default you confirm each call; you can switch that off for this tool.

    MCP callontraccr_write → submit_form

    REST endpointPOST https://cotlet.dev/api/v1/ontraccr/form/submit

    Parameters

    Parameters: submit_form
    NameTypeDescription
    form string required string Form template.
    from string string Where it starts: `manual`, `card`, `task` or `equipment`.
    linked string string The card, task or equipment it belongs to.
    answers object required object Field values.

    Example input

    {
      "form": "form",
      "answers": "answers"
    }

    Example response

    {
      "form": "Daily Site Report",
      "number": "DSR-0412",
      "project": "Maple Street watermain",
      "submitted": true
    }
  • manage_form_templates List form templates or create one from scratch or from an Ontraccr template. writeAsks first

    Templates live under Documents > Forms > Templates. Your crews fill them in the field, so changes wait for your OK. By default you confirm each call; you can switch that off for this tool.

    MCP callontraccr_write → manage_form_templates

    REST endpointPOST https://cotlet.dev/api/v1/ontraccr/form-templates/manage

    Parameters

    Parameters: manage_form_templates
    NameTypeDescription
    action string required string One of `list`, `get`, `create`, `update`. `list` and `get` only read.
    name string string Form name.
    type string string Form type.
    fields array array Fields and sections.
    division string string Division.

    Example input

    {
      "action": "action"
    }

    Example response

    {
      "form": "Daily Site Report",
      "type": "Daily Log",
      "fields": 9,
      "saved": true
    }
  • manage_form_workflows Read a form's workflow or add a Form Trigger block to it. writeAsks first

    The Form Trigger block launches linked forms after submit, approval or edit, with linked numbers and mapped fields. It affects every future submission. By default you confirm each call; you can switch that off for this tool.

    MCP callontraccr_write → manage_form_workflows

    REST endpointPOST https://cotlet.dev/api/v1/ontraccr/form-workflows/manage

    Parameters

    Parameters: manage_form_workflows
    NameTypeDescription
    action string required string One of `get`, `add_form_trigger`. `list` and `get` only read.
    form string required string The parent form template.
    triggered_form string string Form to launch next.
    recipients array array Who fills it in.
    shared boolean boolean One shared form, or one per user.
    mapping object object Parent fields copied into the new form.

    Example input

    {
      "action": "action",
      "form": "form"
    }

    Example response

    {
      "form": "Site Inspection",
      "triggered_form": "Deficiency Report",
      "shared": true,
      "saved": true
    }
  • add_signature_step Add a Collect External Signature step to a form's workflow, with signers in order. writeAsks first

    Your DocuSign account must be connected in Settings > Integrations > DocuSign. Each future submission of the form then goes to clients or vendors by secure link, and the signed PDF locks the form data. By default you confirm each call; you can switch that off for this tool.

    MCP callontraccr_write → add_signature_step

    REST endpointPOST https://cotlet.dev/api/v1/ontraccr/signature-steps

    Parameters

    Parameters: add_signature_step
    NameTypeDescription
    form string required string Form template, for example Change Order.
    after string string The step it follows, usually Submit or Approval.
    signers array required array Signers in signing order: a fixed email or a form field that holds one.

    Example input

    {
      "form": "form",
      "signers": "signers"
    }

    Example response

    {
      "form": "Change Order",
      "after": "Approval",
      "signers": [
        "Client email field"
      ],
      "saved": true
    }
  • add_payment_step Add a Collect Payment step to a form's workflow, or read the payment status of a submission. writeAsks first

    Needs Stripe linked in Settings > Integrations > Stripe. Each submission then sends the customer a Stripe payment link; `status` reads Pending, Paid or Failed. By default you confirm each call; you can switch that off for this tool.

    MCP callontraccr_write → add_payment_step

    REST endpointPOST https://cotlet.dev/api/v1/ontraccr/payment-steps

    Parameters

    Parameters: add_payment_step
    NameTypeDescription
    action string required string One of `add`, `status`. `list` and `get` only read.
    form string required string Form template for `add`, form number for `status`.
    amount_field string string For `add`: the form field with the amount.
    payer_field string string For `add`: the field with the customer email.

    Example input

    {
      "action": "action",
      "form": "form"
    }

    Example response

    {
      "form": "SRV-0208",
      "amount": 1250,
      "status": "Pending"
    }
  • publish_external_form Turn on External Form for a template and get its public link and QR code. writeAsks first

    Anyone with the link can submit without a login, so publishing waits for your OK. By default you confirm each call; you can switch that off for this tool.

    MCP callontraccr_write → publish_external_form

    REST endpointPOST https://cotlet.dev/api/v1/ontraccr/external-form/publish

    Parameters

    Parameters: publish_external_form
    NameTypeDescription
    form string required string Form template.

    Example input

    {
      "form": "form"
    }

    Example response

    {
      "form": "Site Visitor Sign-In",
      "url": "https://example.com/f/visitor",
      "qr_code": true
    }
  • export_form_report Run a Custom Form Export: chosen columns from one form, filtered by date or division. read

    Returns the rows of the export as Ontraccr builds them, the same data as its CSV. Use it for daily log, time and material or inspection summaries.

    MCP callontraccr_read → export_form_report

    REST endpointGET https://cotlet.dev/api/v1/ontraccr/form-reports/export

    Parameters

    Parameters: export_form_report
    NameTypeDescription
    export string required string Export title from Settings > Forms > Exports.
    from string string ISO start date.
    to string string ISO end date.
    division string string Division, if you use several.

    Example input

    {
      "export": "export"
    }

    Example response

    {
      "export": "Daily Log Report",
      "rows": [
        {
          "project": "Maple Street watermain",
          "date": "2026-11-16",
          "crew_size": 6
        }
      ]
    }

Boards, cards and tasks8

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

  • manage_cards List a board's cards, create a card or move it to another status. writeAsks first

    A card is a job, lead, request or anything you track. Moving a card can start the board's workflows, such as copying it or creating tasks. By default you confirm each call; you can switch that off for this tool.

    MCP callontraccr_write → manage_cards

    REST endpointPOST https://cotlet.dev/api/v1/ontraccr/cards/manage

    Parameters

    Parameters: manage_cards
    NameTypeDescription
    action string required string One of `list`, `get`, `create`, `move`. `list` and `get` only read.
    board string required string Board title.
    card string string Card title, for `get` and `move`.
    status string string Status column.
    assigned array array Assigned users.
    linked array array Linked project, customer, equipment or material.

    Example input

    {
      "action": "action",
      "board": "board"
    }

    Example response

    {
      "board": "Active Jobs",
      "card": "Maple Street watermain",
      "status": "Ready to Bill",
      "saved": true
    }
  • manage_card_tasks Read the Tasks tab of a card or add a task to it. writeAsks first

    The task appears in the assignee's My Tasks, so new and reassigned tasks wait for your OK. By default you confirm each call; you can switch that off for this tool.

    MCP callontraccr_write → manage_card_tasks

    REST endpointPOST https://cotlet.dev/api/v1/ontraccr/card-tasks/manage

    Parameters

    Parameters: manage_card_tasks
    NameTypeDescription
    action string required string One of `list`, `create`, `update`. `list` and `get` only read.
    board string required string Board title.
    card string required string The card.
    title string string Task title.
    assignees array array Users.
    due_date string string ISO date.
    priority string string Priority.
    status string string One of `To Do`, `In Progress`, `Done`.

    Example input

    {
      "action": "action",
      "board": "board",
      "card": "card"
    }

    Example response

    {
      "card": "Maple Street watermain",
      "task": "Book the vac truck",
      "assignees": [
        "Site lead"
      ],
      "due_date": "2026-11-19",
      "status": "To Do"
    }
  • manage_my_tasks List the tasks assigned to you across boards, or mark one done. writeAsks first

    My Tasks sorts by due date and covers card and equipment tasks. Completing a task can move its card on. By default you confirm each call; you can switch that off for this tool.

    MCP callontraccr_write → manage_my_tasks

    REST endpointPOST https://cotlet.dev/api/v1/ontraccr/my-tasks/manage

    Parameters

    Parameters: manage_my_tasks
    NameTypeDescription
    action string required string One of `list`, `complete`. `list` and `get` only read.
    task string string Task title, for `complete`.

    Example input

    {
      "action": "action"
    }

    Example response

    {
      "tasks": [
        {
          "task": "Book the vac truck",
          "type": "Card Task",
          "due": "2026-11-19",
          "priority": "High"
        }
      ]
    }
  • manage_boards List boards or create one with its statuses, card design and division. writeAsks first

    A board can track any workflow, from jobs to procurement. Statuses become its columns. By default you confirm each call; you can switch that off for this tool.

    MCP callontraccr_write → manage_boards

    REST endpointPOST https://cotlet.dev/api/v1/ontraccr/boards/manage

    Parameters

    Parameters: manage_boards
    NameTypeDescription
    action string required string One of `list`, `create`. `list` and `get` only read.
    title string string Board title, for `create`.
    card_design string string Card type the board uses.
    statuses array array Status columns in order.
    division string string Division, if you use several.

    Example input

    {
      "action": "action"
    }

    Example response

    {
      "board": "Site Equipment Tracker",
      "card_design": "Equipment Request",
      "statuses": [
        "Requested",
        "Approved",
        "Delivered"
      ],
      "saved": true
    }
  • manage_card_designs List card designs or create one with its fields and sections. writeAsks first

    Card designs live under Settings > Boards and are reused across boards, so a change shows on every board that uses the design. By default you confirm each call; you can switch that off for this tool.

    MCP callontraccr_write → manage_card_designs

    REST endpointPOST https://cotlet.dev/api/v1/ontraccr/card-designs/manage

    Parameters

    Parameters: manage_card_designs
    NameTypeDescription
    action string required string One of `list`, `create`, `update`. `list` and `get` only read.
    title string string Card design title.
    fields array array Text, dropdown, date, number and other fields, with required flags.

    Example input

    {
      "action": "action"
    }

    Example response

    {
      "card_design": "Service Tracker",
      "fields": [
        "Customer",
        "Site address",
        "Due date",
        "Priority"
      ],
      "saved": true
    }
  • manage_board_workflows List a board's workflows or add one, such as copy a card on a status. writeAsks first

    A workflow runs on every future card that enters the status, so the agent names the trigger and target first. By default you confirm each call; you can switch that off for this tool.

    MCP callontraccr_write → manage_board_workflows

    REST endpointPOST https://cotlet.dev/api/v1/ontraccr/board-workflows/manage

    Parameters

    Parameters: manage_board_workflows
    NameTypeDescription
    action string required string One of `list`, `create`. `list` and `get` only read.
    board string required string Board title.
    type string string Workflow type, for example Copy Card When Status Changes.
    trigger_status string string Status that starts it.
    target_board string string Where the copy goes.

    Example input

    {
      "action": "action",
      "board": "board"
    }

    Example response

    {
      "board": "Sales",
      "workflow": "Copy to Estimating Board",
      "trigger_status": "Send to Estimating",
      "target_board": "Estimating",
      "saved": true
    }
  • search_records Run an Advanced Search across boards or forms with field filters. read

    A board search is built around a card design and can span every board that uses it. Returns the matching cards or forms with their fields.

    MCP callontraccr_read → search_records

    REST endpointGET https://cotlet.dev/api/v1/ontraccr/records/search

    Parameters

    Parameters: search_records
    NameTypeDescription
    source string required string One of `boards`, `forms`.
    card_design string string For boards: the card design, for example Project Tracker.
    boards array array Boards that use that design. Leave empty for all.
    filters array array Field, operator and value, on standard or custom fields.

    Example input

    {
      "source": "source"
    }

    Example response

    {
      "card_design": "Project Tracker",
      "results": [
        {
          "card": "Maple Street watermain",
          "board": "Active Jobs",
          "status": "In Progress"
        }
      ]
    }
  • manage_dashboards Read a dashboard's widgets, create a dashboard or add a widget. writeAsks first

    Dashboards gather analytics from boards, forms and time cards; the default one has Clock, Live Feed and Quick Stats. By default you confirm each call; you can switch that off for this tool.

    MCP callontraccr_write → manage_dashboards

    REST endpointPOST https://cotlet.dev/api/v1/ontraccr/dashboards/manage

    Parameters

    Parameters: manage_dashboards
    NameTypeDescription
    action string required string One of `get`, `create`, `add_widget`. `list` and `get` only read.
    dashboard string required string Dashboard name.
    widget object object For `add_widget`: type and the board, form or time card analytics it shows.

    Example input

    {
      "action": "action",
      "dashboard": "dashboard"
    }

    Example response

    {
      "dashboard": "Safety Compliance Overview",
      "widgets": [
        "Quick Stats",
        "Inspections this week"
      ],
      "saved": true
    }

Projects, budgets and contracts6

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

  • manage_projects List or read projects, or create one through the Add Project steps. writeAsks first

    Most tools take a project, so `list` usually comes first. A blank project number is generated and must be unique. By default you confirm each call; you can switch that off for this tool.

    MCP callontraccr_write → manage_projects

    REST endpointPOST https://cotlet.dev/api/v1/ontraccr/projects/manage

    Parameters

    Parameters: manage_projects
    NameTypeDescription
    action string required string One of `list`, `get`, `create`, `update`. `list` and `get` only read.
    project string string Name or number, for `get` and `update`.
    fields object object Name, division, location, number, client, type, geofence radius, info, billing and budget.

    Example input

    {
      "action": "action"
    }

    Example response

    {
      "project": "Maple Street watermain",
      "number": "P-2026-118",
      "client": "Example Municipality",
      "saved": true
    }
  • view_project_budget Read the Budget Tracking tab of a project, with its cost code breakdown. read

    Returns the summary (estimated labor hours and costs, material, overhead and equipment costs, burden rate, contract value, expected profit) and per cost code the allocated hours and forecasted costs, including subcontract budgets.

    MCP callontraccr_read → view_project_budget

    REST endpointGET https://cotlet.dev/api/v1/ontraccr/project-budgets/view

    Parameters

    Parameters: view_project_budget
    NameTypeDescription
    project string required string Project name or number, as manage_projects `list` returns it.

    Example input

    {
      "project": "project"
    }

    Example response

    {
      "project": "Maple Street watermain",
      "contract_value": 486000,
      "expected_profit": 58300,
      "cost_codes": [
        {
          "code": "02-200",
          "name": "Trenching",
          "allocated_hours": 320,
          "forecast": 41200
        }
      ]
    }
  • run_project_status_report Compare estimated and actual labor hours per phase and cost code. read

    Returns estimated hours (from the budget), actual hours (from progress), remaining hours and the percentage used. Labor only: no materials, overhead or equipment.

    MCP callontraccr_read → run_project_status_report

    REST endpointGET https://cotlet.dev/api/v1/ontraccr/project-status-reports/run

    Parameters

    Parameters: run_project_status_report
    NameTypeDescription
    project string required string Project name or number, as manage_projects `list` returns it.

    Example input

    {
      "project": "project"
    }

    Example response

    {
      "project": "Maple Street watermain",
      "rows": [
        {
          "phase": "Excavation",
          "cost_code": "02-200",
          "estimated": 320,
          "actual": 288,
          "used": "90%"
        }
      ]
    }
  • manage_project_contract Read or change a project's Contract tab: schedule of values, change orders, holdback. writeAsks first

    The contract drives progress billing to your client, so every change waits for your OK. Approved and pending change orders are tracked apart. By default you confirm each call; you can switch that off for this tool.

    MCP callontraccr_write → manage_project_contract

    REST endpointPOST https://cotlet.dev/api/v1/ontraccr/project-contract/manage

    Parameters

    Parameters: manage_project_contract
    NameTypeDescription
    action string required string One of `get`, `add_item`, `add_change_order`. `list` and `get` only read.
    project string required string Project name or number, as manage_projects `list` returns it.
    item object object Description, amount and holdback or retainage.

    Example input

    {
      "action": "action",
      "project": "project"
    }

    Example response

    {
      "project": "Maple Street watermain",
      "contract_value": 486000,
      "change_orders": [
        {
          "title": "Extra hydrant",
          "amount": 8400,
          "status": "Pending"
        }
      ]
    }
  • manage_cost_codes List cost codes or create one, globally or inside a project. writeAsks first

    Number and name must be unique; the agent runs `list` first. By default you confirm each call; you can switch that off for this tool.

    MCP callontraccr_write → manage_cost_codes

    REST endpointPOST https://cotlet.dev/api/v1/ontraccr/cost-codes/manage

    Parameters

    Parameters: manage_cost_codes
    NameTypeDescription
    action string required string One of `list`, `create`. `list` and `get` only read.
    number string string Unique cost code number.
    name string string Unique name, for example Fire Alarm.
    description string string What the work is.
    project string string Leave empty for a global code.

    Example input

    {
      "action": "action"
    }

    Example response

    {
      "number": "02-210",
      "name": "Backfill",
      "saved": true
    }
  • manage_gantt Read a project's Gantt tab, add a task or import a Microsoft schedule file. writeAsks first

    Tasks can be dispatched to the Field Schedule, so date changes reach crews. By default you confirm each call; you can switch that off for this tool.

    MCP callontraccr_write → manage_gantt

    REST endpointPOST https://cotlet.dev/api/v1/ontraccr/gantt/manage

    Parameters

    Parameters: manage_gantt
    NameTypeDescription
    action string required string One of `list`, `add_task`, `import`. `list` and `get` only read.
    project string required string Project name or number, as manage_projects `list` returns it.
    task object object Name, start, end and the task it depends on.
    file_url string string For `import`: a link to the file.

    Example input

    {
      "action": "action",
      "project": "project"
    }

    Example response

    {
      "project": "Maple Street watermain",
      "task": "Pipe install, block 2",
      "start": "2026-11-23",
      "end": "2026-11-27",
      "saved": true
    }

Customers and buckets3

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

  • manage_customers List customers under Contacts or add one with its contact fields. writeAsks first

    Run `list` first so the same customer is not added twice. Labels such as Commercial are created if new. By default you confirm each call; you can switch that off for this tool.

    MCP callontraccr_write → manage_customers

    REST endpointPOST https://cotlet.dev/api/v1/ontraccr/customers/manage

    Parameters

    Parameters: manage_customers
    NameTypeDescription
    action string required string One of `list`, `get`, `create`, `update`. `list` and `get` only read.
    customer string string Name, for `get` and `update`.
    fields object object Name, division, labels, bucket, office and mobile phone, office and billing email, website.

    Example input

    {
      "action": "action"
    }

    Example response

    {
      "customer": "Example Municipality",
      "labels": [
        "Commercial"
      ],
      "billing_email": "ap@example.com",
      "saved": true
    }
  • broadcast_client_message Send a message to all Client Portal users or to chosen customers. writeAsks first

    Customers see it in their portal and get an email about it. It reaches people outside your company. By default you confirm each call; you can switch that off for this tool.

    MCP callontraccr_write → broadcast_client_message

    REST endpointPOST https://cotlet.dev/api/v1/ontraccr/client-message/broadcast

    Parameters

    Parameters: broadcast_client_message
    NameTypeDescription
    to string required string `all` or a list of customers with Client Portal accounts.
    text string required string The message.

    Example input

    {
      "to": "to",
      "text": "text"
    }

    Example response

    {
      "recipients": 4,
      "sent": true
    }
  • manage_buckets List buckets or create a custom database linked to customers, projects or equipment. writeAsks first

    Buckets are set up under Settings > Customization > Buckets. By default you confirm each call; you can switch that off for this tool.

    MCP callontraccr_write → manage_buckets

    REST endpointPOST https://cotlet.dev/api/v1/ontraccr/buckets/manage

    Parameters

    Parameters: manage_buckets
    NameTypeDescription
    action string required string One of `list`, `create`. `list` and `get` only read.
    name string string Bucket name.
    parents array array Customers or buckets that link to it.
    children array array Projects, equipment or buckets it links to.

    Example input

    {
      "action": "action"
    }

    Example response

    {
      "bucket": "Highway Segment A",
      "parents": [
        "Example Municipality"
      ],
      "saved": true
    }

Equipment, materials and inventory6

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

  • manage_equipment List equipment or add a piece with name, division and status. writeAsks first

    Name, division and status are required. By default you confirm each call; you can switch that off for this tool.

    MCP callontraccr_write → manage_equipment

    REST endpointPOST https://cotlet.dev/api/v1/ontraccr/equipment/manage

    Parameters

    Parameters: manage_equipment
    NameTypeDescription
    action string required string One of `list`, `get`, `create`, `update`. `list` and `get` only read.
    name string string For example Ford F150.
    status string string For example Active or Needs Repair.
    fields object object ID, type and other optional fields.

    Example input

    {
      "action": "action"
    }

    Example response

    {
      "equipment": "Excavator 3",
      "status": "Active",
      "id": "EQ-103",
      "saved": true
    }
  • check_equipment Check a piece of equipment in to a project or out again. writeAsks first

    Check-in starts a usage timer and adds a timeline record; check-out stops it. By default you confirm each call; you can switch that off for this tool.

    MCP callontraccr_write → check_equipment

    REST endpointPOST https://cotlet.dev/api/v1/ontraccr/equipment/check

    Parameters

    Parameters: check_equipment
    NameTypeDescription
    equipment string required string Equipment name or ID.
    direction string required string One of `in`, `out`.
    project string string For `in`: project or location.

    Example input

    {
      "equipment": "equipment",
      "direction": "direction"
    }

    Example response

    {
      "equipment": "Excavator 3",
      "project": "Maple Street watermain",
      "active": true
    }
  • manage_inventory Read material quantities by location or set the low-stock threshold. writeAsks first

    Below the threshold Ontraccr raises a low-stock alert. By default you confirm each call; you can switch that off for this tool.

    MCP callontraccr_write → manage_inventory

    REST endpointPOST https://cotlet.dev/api/v1/ontraccr/inventory/manage

    Parameters

    Parameters: manage_inventory
    NameTypeDescription
    action string required string One of `list`, `update`. `list` and `get` only read.
    material string string Material.
    threshold number number Low-stock alert level.
    quantity number number Quantity at a location.
    location string string Location, job or vehicle.

    Example input

    {
      "action": "action"
    }

    Example response

    {
      "material": "8 in PVC pipe",
      "threshold": 20,
      "locations": [
        {
          "location": "Yard",
          "quantity": 34
        }
      ]
    }
  • import_materials Upload a material list from an XLS or XLSX spreadsheet. writeAsks first

    Name, description and part number are required columns; supplier, purchase cost, markup, units and quantity are optional. The agent reports the row count first. By default you confirm each call; you can switch that off for this tool.

    MCP callontraccr_write → import_materials

    REST endpointPOST https://cotlet.dev/api/v1/ontraccr/materials

    Parameters

    Parameters: import_materials
    NameTypeDescription
    file_url string required string A link to the spreadsheet.
    worksheet string string Tab to read.
    division string string Division.

    Example input

    {
      "file_url": "https://example.com"
    }

    Example response

    {
      "rows": 212,
      "imported": true
    }
  • manage_assemblies List assemblies or bundle existing materials into one. writeAsks first

    An assembly is quoted and tracked as one line item; its cost is calculated from its parts. By default you confirm each call; you can switch that off for this tool.

    MCP callontraccr_write → manage_assemblies

    REST endpointPOST https://cotlet.dev/api/v1/ontraccr/assemblies/manage

    Parameters

    Parameters: manage_assemblies
    NameTypeDescription
    action string required string One of `list`, `create`. `list` and `get` only read.
    name string string Assembly name.
    materials array array Material and quantity per part.

    Example input

    {
      "action": "action"
    }

    Example response

    {
      "assembly": "Hydrant set",
      "materials": 5,
      "saved": true
    }
  • bulk_edit_labor_costs Add to the labor cost or labor markup of selected materials or assemblies. writeAsks first

    Changes are additive: $3 plus $2 becomes $5. The agent lists the selection first. By default you confirm each call; you can switch that off for this tool.

    MCP callontraccr_write → bulk_edit_labor_costs

    REST endpointPOST https://cotlet.dev/api/v1/ontraccr/edit-labor-costs/bulk

    Parameters

    Parameters: bulk_edit_labor_costs
    NameTypeDescription
    items array required array Materials or assemblies.
    field string required string One of `labor_cost`, `labor_markup`.
    change number required number Dollars to add, or percent.

    Example input

    {
      "items": "items",
      "field": "field",
      "change": 1
    }

    Example response

    {
      "items": 14,
      "field": "labor_cost",
      "change": 2,
      "saved": true
    }

Files and notes4

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

  • manage_project_files List a project's folders and files, create a folder or upload a file. writeAsks first

    Every project has its own folder under Files > Main > Projects. A file with an existing name becomes a new version. By default you confirm each call; you can switch that off for this tool.

    MCP callontraccr_write → manage_project_files

    REST endpointPOST https://cotlet.dev/api/v1/ontraccr/project-files/manage

    Parameters

    Parameters: manage_project_files
    NameTypeDescription
    action string required string One of `list`, `create_folder`, `upload`. `list` and `get` only read.
    project string required string Project name or number, as manage_projects `list` returns it.
    folder string string Folder path.
    file_url string string For `upload`: a link to the file.

    Example input

    {
      "action": "action",
      "project": "project"
    }

    Example response

    {
      "project": "Maple Street watermain",
      "folder": "Permits",
      "file": "Road closure permit.pdf",
      "uploaded": true
    }
  • annotate_file Add highlights, boxes or text to a drawing or document and save it. writeAsks first

    Saving annotations creates a new version; earlier versions stay in list_file_versions. By default you confirm each call; you can switch that off for this tool.

    MCP callontraccr_write → annotate_file

    REST endpointPOST https://cotlet.dev/api/v1/ontraccr/file/annotate

    Parameters

    Parameters: annotate_file
    NameTypeDescription
    project string required string Project name or number, as manage_projects `list` returns it.
    file string required string File name.
    marks array required array Type (`highlight`, `rectangle`, `text`), page, position and text.

    Example input

    {
      "project": "project",
      "file": "file",
      "marks": "marks"
    }

    Example response

    {
      "file": "Site plan rev C.pdf",
      "marks": 2,
      "version": 4
    }
  • list_file_versions List the saved versions of a file and get a download link for one. read

    Ontraccr saves a new version when someone saves annotations or uploads a file with the same name. Earlier versions stay available.

    MCP callontraccr_read → list_file_versions

    REST endpointGET https://cotlet.dev/api/v1/ontraccr/file-versions

    Parameters

    Parameters: list_file_versions
    NameTypeDescription
    project string required string Project name or number, as manage_projects `list` returns it.
    file string required string File name.
    version number number Version to download. Leave empty to list them.

    Example input

    {
      "project": "project",
      "file": "file"
    }

    Example response

    {
      "file": "Site plan rev C.pdf",
      "versions": [
        {
          "version": 3,
          "saved": "2026-11-15",
          "by": "Site lead"
        },
        {
          "version": 2,
          "saved": "2026-11-10",
          "by": "Estimator"
        }
      ]
    }
  • add_project_note Read a project's Notes tab or post a note with an optional file and mentions. writeAsks first

    A mention sends the user a push notification, so notes wait for your OK. By default you confirm each call; you can switch that off for this tool.

    MCP callontraccr_write → add_project_note

    REST endpointPOST https://cotlet.dev/api/v1/ontraccr/project-notes

    Parameters

    Parameters: add_project_note
    NameTypeDescription
    action string required string One of `list`, `create`. `list` and `get` only read.
    project string required string Project name or number, as manage_projects `list` returns it.
    text string string The note; @username mentions notify that user.
    file_url string string Attachment.

    Example input

    {
      "action": "action",
      "project": "project"
    }

    Example response

    {
      "project": "Maple Street watermain",
      "note": "@SiteLead permit is in Files > Permits.",
      "saved": true
    }
Encrypted, revocable

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).

34 tools ask first

Approvals, undo and mistakes Crews, clients and vendors get nothing until you say so.

  1. 01 Pick the project and date manage_projects finds the job.
  2. 02 Draft the time Users, start, end, break and cost code.
  3. 03 Show you the hours Per person and in total, before saving.
  4. 04 Save after your OK enter_time writes the team entry.
Fixing an Ontraccr write that went wrong
ActionHow to put it right
Card status, card task, draft shiftCall manage_cards, manage_card_tasks or schedule_shifts again with the right values
Time entry or approvalEdit the entry in Team Cards; payroll may already have read it
Published shift or project note with a mentionThe crew was notified: tell them the change
Client Portal broadcast, signature or payment linkAlready 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.

Pay per call

How much does the Ontraccr MCP server cost?

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

Illustrative month, our assumption: successful calls for this workload
JobCallsCredits
Morning form approvals2 × 22440
Friday time card review and payroll report3 × 4120
Field shifts for next week12 × 4480
Board card moves and follow-up tasks2 × 40800
Weekly budget and status, four projects8 × 4320
Equipment check in and out1 × 40400
Daily site report submissions1 × 22220
Cloud Browser, 30 days1,500
Total278 calls4,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.

Cotlet credit packs: price, credits and calls at 10 credits each
Credits Price, one time Calls at 10 credits Per 1,000 credits
5,000 $29 500 $5.80
15,000 $79 1,500 $5.27
32,000 $149 3,200 $4.66
60,000 $249 6,000 $4.15

Only successful calls use credits; failed calls and timeouts cost nothing. At a balance of 0 calls pause, never a surprise charge. Authenticate with the Authorization: Bearer header.

Other options

Ontraccr MCP server: other ways to connect What each route does for a contractor, and where it stops.

Other ways to work with Ontraccr, checked 17 Nov 2026
OptionWhat it doesWhere it stops
Ontraccr on ZapierCard Moved trigger and Create a Board Card action.Nothing for forms, time cards, projects or equipment.
Zapier MCPPuts that Ontraccr action in front of ChatGPT or Claude.The same single action, run through your Zapier account.
Ontraccr's own integrationsQuickBooks Online, Sage 100 Contractor, Stripe, Gmail, DocuSign.Accounting, payment and signature links, not a route for an AI agent.
Custom Form ExportsChosen 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.

EU company, since 2019

Who runs Cotlet A company you can look up.

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.

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.

Let your agent clear this week's Ontraccr approvals.

Free 7-day trial with 2,000 credits, no card needed.