Ontraccr MCP Server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Ontraccr MCP Server Review my team cards waiting for approval this week."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Ontraccr MCP server for ChatGPT and Claude
ChatGPT, Claude and other AI agents can work with your Ontraccr account through Cotlet.dev. Connect your own signed-in Cloud Browser to review time cards, approve forms, draft field shifts and check project budgets. Approvals, published shifts and actions that reach clients or crews wait for your confirmation.
What you can ask
Review Team Cards waiting for my approval.
List forms pending my approval.
Draft field shifts for next week for my review.
Check hours used against the project budget.
Prepare a change order for signature for my approval.
Move a job card and assign the follow-up.
Related MCP server: ConstructionOnline MCP Server
Connect your account
Get your API key at https://cotlet.dev/app and export it as COTLET_API_KEY.
ChatGPT
Add https://cotlet.dev/mcp/v1/connect in Settings > Apps & Connectors, then sign in to Cotlet.dev with OAuth.
Claude
Add https://cotlet.dev/mcp/v1/connect in Settings > Connectors > Add custom connector.
Claude Code
claude mcp add --transport http cotlet https://cotlet.dev/mcp/v1 --header "Authorization: Bearer $COTLET_API_KEY"Cursor
Copy .cursor/mcp.json from this repo into your project:
{
"mcpServers": {
"cotlet": {
"url": "https://cotlet.dev/mcp/v1",
"headers": {
"Authorization": "Bearer ${COTLET_API_KEY}"
}
}
}
}Run it locally (stdio)
This repo is a real MCP server. It speaks MCP over stdio, lists its Ontraccr tools without any key, and forwards every tool call to the hosted Cotlet.dev server. The hosted URL above stays the recommended way. Use this when your client only starts local servers.
git clone https://github.com/cotlet-connect/ontraccr-mcp.git
cd ontraccr-mcp
python3 ontraccr_agent.py serveOr with Docker:
docker build -t ontraccr-mcp .
docker run -i --rm -e COTLET_API_KEY ontraccr-mcpTools: ontraccr_guide, ontraccr_status, ontraccr_open, ontraccr_read, ontraccr_click, ontraccr_type, ontraccr_close. Without COTLET_API_KEY a tool call answers: "Set COTLET_API_KEY. Get a key at https://cotlet.dev/app".
Command line
Python 3.10+, standard library only. Run from this repository:
export COTLET_API_KEY="your-key"
python3 ontraccr_agent.py connect # ready config for Claude Code, Cursor, ChatGPT
python3 ontraccr_agent.py status # is Ontraccr ready in your Cotlet.dev account
python3 ontraccr_agent.py guide # Ontraccr screens and sign-in link
python3 ontraccr_agent.py read # open Ontraccr, read the page, close the browser
python3 ontraccr_agent.py tools # list Cotlet.dev tools
python3 ontraccr_agent.py serve # start the stdio MCP server (same as no argument)Questions from Ontraccr users
Does Ontraccr have a public API or official MCP server?
The Cotlet.dev integration page reports no public Ontraccr API documentation, official Ontraccr MCP server or official ChatGPT or Claude connector found, checked 17 November 2026.
How do I connect Ontraccr to ChatGPT?
Sign up at https://cotlet.dev/signup?app=ontraccr and sign in at app.ontraccr.com/login in your Cotlet.dev Cloud Browser. Add https://cotlet.dev/mcp/v1/connect in ChatGPT with OAuth.
Can I use Ontraccr with Claude?
Yes. Add https://cotlet.dev/mcp/v1/connect as a custom connector in Claude and sign in to Cotlet.dev.
Is this an official Ontraccr MCP server?
No. Cotlet.dev is independent and is not affiliated with, endorsed by or sponsored by Ontraccr.
Integration details
https://cotlet.dev/integrations/ontraccr-api-mcp-server
Start free: https://cotlet.dev/signup?app=ontraccr&utm_source=github&utm_medium=readme&utm_campaign=ontraccr
Available Tools
7 toolsontraccr_clickB
Click a numbered element on the current Ontraccr page.
Inputs: element (required).
ontraccr_closeA
Close the Ontraccr browser session when the work is done, so credits stop running.
Inputs: no named parameters.
ontraccr_guideB
How to work in Ontraccr (crew time cards, form approvals, field shifts, project budgets and board cards): its screens and the sign-in link. Call this first.
Inputs: task.
ontraccr_openB
Open a Ontraccr page in your signed-in Cloud Browser (default https://app.ontraccr.com/login) to work with crew time cards, form approvals, field shifts, project budgets and board cards.
Inputs: url.
ontraccr_readA
Read the current Ontraccr page: its text and numbered buttons, links and fields.
Inputs: element.
ontraccr_statusB
Check that your Cotlet.dev account and Ontraccr are ready: account, credits and Ontraccr connection.
Inputs: no named parameters.
ontraccr_typeB
Type text into a numbered field on the current Ontraccr page.
Inputs: text (required), element (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 7 tools
The set splits cleanly into meta tools (guide, status), browser lifecycle (open, close), and page interaction (read, click, type), each with a distinct role. The only mild overlap is guide vs. status, both being 'call before doing work' orientation tools, but their descriptions clearly separate onboarding instructions from connectivity/credit checks.
Every tool uses the same ontraccr_<verb> snake_case pattern with a short, single-purpose verb. There are no mixed conventions or variant spellings, so the pattern is fully predictable.
Seven tools is tightly scoped for a browser-automation wrapper: two setup/readiness tools, three interaction primitives, and open/close lifecycle. Nothing appears redundant and no obvious primitive is missing from the count.
The core agent loop (open a page, read it, click/type, close) is fully covered, plus guidance and status checks. Minor gaps remain for common DOM interactions such as scrolling, selecting dropdown options, or pressing keys, which agents will have to work around via clicking and typing.
Related MCP Connectors
Contractor Foreman MCP server for ChatGPT, Claude and any AI agent: create estimate, add daily log, create change order, update schedule, list invoices and get job costing in your own Contractor Foreman account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to Contractor Foreman yourself; Cotlet does not store your password and you need no Contractor Foreman API key. About the official Contractor Foreman API: Contractor Foreman has no public API (checked 11 Oct 2026). Its only programmatic access is a Zapier app with 7 triggers for leads, customers and file uploads, and 2 actions: Create Lead and Create Customer. Setup and FAQ: https://cotlet.dev/integrations/contractor-foreman-api-mcp-server
ClockShark MCP server for ChatGPT, Claude and any AI agent: list time entries, approve timesheet, create job, schedule shift and export payroll hours in your own ClockShark account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to ClockShark yourself; Cotlet does not store your password and you need no ClockShark API key. About the official ClockShark API: ClockShark has no public developer API or API docs (checked 10 Oct 2026). Admins can only generate a Zapier API key, which Zapier uses for 6 triggers and 2 actions: Create Job and Create Task. Setup and FAQ: https://cotlet.dev/integrations/clockshark-api-mcp-server
Hubstaff MCP server for ChatGPT, Claude and any AI agent: list timesheets, approve timesheet, review manual time request, add time entry, create project and create task in your own Hubstaff account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to Hubstaff yourself; Cotlet does not store your password and you need no Hubstaff API key. About the official Hubstaff API: Hubstaff has a full REST API, API v2, with read and write scopes, and an official MCP server that is read-only (checked 17 Oct 2026). The MCP server reads organizations, members, projects, tasks and time and activity data for owners and managers, cannot create or change anything, and is switched on per organization after an email to Hubstaff support. Setup and FAQ: https://cotlet.dev/integrations/hubstaff-api-mcp-server
Buildertrend MCP server for ChatGPT, Claude and any AI agent: get schedule, create daily log, create change order and list selections in your own Buildertrend account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to Buildertrend yourself; Cotlet does not store your password and you need no Buildertrend API key. About the official Buildertrend API: Buildertrend publishes no API docs or self-serve keys for customers; it connects through its Marketplace integrations (checked 11 Oct 2026). Setup and FAQ: https://cotlet.dev/integrations/buildertrend-api-mcp-server
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceEnables AI agents to work with a signed-in Buildern contractor account through Cotlet.dev, including estimates, schedules, budgets, bills, client invoices, project to-dos, and site diaries, with review before write operations.Elastic 2.0
- AlicenseAqualityBmaintenanceConnects ChatGPT, Claude, Codex and Claude Code through Cotlet.dev to a signed-in construction management account, enabling work with projects, estimates, bids, change orders, daily logs, RFIs, invoices and related workflows. It exposes 31 read and write capabilities, most write actions requiring confirmation before anything is sent or changed.7Elastic 2.0
- AlicenseAqualityBmaintenanceConnects a signed-in Bolster contractor account to ChatGPT, Claude, Codex, and Claude Code through Cotlet.dev so users can manage estimates, proposals, schedules, job budgets, bid requests, and customer payment requests, with write actions reviewed before approval.7Elastic 2.0
- AlicenseAqualityBmaintenanceEnables ChatGPT, Claude and other AI agents to manage availability, blocked time, forms, invoices and client reports in a signed-in account, with write actions requiring approval by default. It connects through Cotlet.dev either as a hosted endpoint or as a local stdio server that forwards tool calls.7Elastic 2.0