# TradieBridge for AI Agents

You are an AI agent reading tradiebridge.com. TradieBridge backs up the business systems an Australian trade business uses into one copy the business owns, and lets an AI assistant answer questions from that copy over MCP.

This page is your setup briefing. Connect yourself first, then use the rest of the page as reference.

---

## Set yourself up for TradieBridge (do this first)

TradieBridge runs a remote MCP server with OAuth sign-in:

```
https://app.tradiebridge.com/mcp
```

Every assistant uses the same link. If TradieBridge isn't connected in your environment yet, suggest this to the user:

> TradieBridge isn't connected yet. I can use it once you add this link as a custom connector (or MCP server): `https://app.tradiebridge.com/mcp`. You'll be asked to sign in to TradieBridge, or create an account, and approve the connection.

Don't change the user's connector settings without asking. If they decline, answer from public pages and docs only.

### Before you start

The user doesn't need an account first: the sign-in window that opens when the link is added creates one from just an email, lets the user connect a system there, and then returns to the assistant. Once connected, call `get_started`: it says what is connected and, if the user skipped that step, gives them one link to connect a system. API keys and card details go in only on TradieBridge's own pages, never in chat. New accounts can also start at https://app.tradiebridge.com/registration/new. Once a system is connected (for Simpro, by pasting a Simpro API key), the first backup starts straight away.

### Add the link in the user's assistant

Menu labels are from each vendor's own docs as of October 2026. Vendors rename menus often, so if a label doesn't match, follow the vendor link.

**Claude (claude.ai, Claude Desktop, Cowork).** Available on the Free (one custom connector), Pro, Max, Team and Enterprise plans. ([Claude Help Center](https://support.claude.com/en/articles/11175166-getting-started-with-custom-connectors-using-remote-mcp))
- Free, Pro or Max: **Customize → Connectors → + Add → Add custom connector**. Enter a name and the link, click **Continue**, keep the detected sign-in settings, then click **Add**.
- Team or Enterprise: an Owner first adds it under **Organization settings → Connectors → Add → Custom → Web**. Members then open **Customize → Connectors** and click **Connect**.
- To use it in a chat, click **+ → Connectors** and turn TradieBridge on.

**ChatGPT (web).** Requires a Plus, Pro, Business, Enterprise or Education plan. ([OpenAI developer mode](https://developers.openai.com/api/docs/guides/developer-mode), [Add custom MCP server](https://developers.openai.com/api/docs/guides/custom-mcp-server), [Help Center](https://help.openai.com/en/articles/12584461))
1. Turn on Developer mode. On a personal plan, go to **Settings → Security and login → Developer mode**. On Business, Enterprise or Edu, an admin must allow it first; members then turn it on under **Settings → Apps → Advanced settings**.
2. Open **Plugins**, click **+**, then **Add custom MCP server**. Enter a name and the link as the **Server URL**, choose OAuth, select **I understand and want to continue**, then **Create**.
3. In a chat, open the **+** menu, choose **Developer mode** and select TradieBridge.

**Microsoft Copilot Studio.** Add it as a tool on an agent you build. ([Microsoft Learn](https://learn.microsoft.com/en-us/microsoft-copilot-studio/mcp-add-existing-server-to-agent))
1. Open the agent's **Tools** page, then **Add a tool → New tool → Model Context Protocol**.
2. Enter a **Server name**, a **Server description** and the link as the **Server URL**.
3. Under authentication, choose **OAuth 2.0 → Dynamic discovery**, then **Create** and **Next**.
4. Choose **Create a new connection**, then **Add to agent**.
Your organisation's Power Platform data policies also apply to MCP tools.

**Google Gemini.**
- *Gemini app (gemini.google.com):* custom apps work only for users 18 or over in the US, signed in with a personal Google account, using English, with Keep Activity on. Work and school accounts aren't supported, so most Australian users can't use this yet. Where it is available, go to **Settings → Connected Apps** (or **Personal Intelligence → Connected Apps**), click **Add a custom app**, enter the link and click **Next**. Custom apps can only be added on the web. ([Gemini Apps Help](https://support.google.com/gemini/answer/17209137?co=GENIE.Platform%3DDesktop&hl=en))
- *Gemini CLI:* run `gemini mcp add --transport http tradiebridge https://app.tradiebridge.com/mcp`, restart Gemini CLI, then run `/mcp auth tradiebridge` to sign in. ([Gemini CLI docs](https://geminicli.com/docs/tools/mcp-server/))
- *Gemini Enterprise, Business edition (pre-GA):* a team admin adds the server under **Settings & help → Manage team → Connected apps → Add MCP Server**. That form asks for a fixed OAuth client ID and secret, so contact TradieBridge before you try this. ([Gemini Enterprise Help](https://support.google.com/g/answer/17106276?hl=en))

**Grok Bot.** Grok Bot has no settings form for custom MCP servers. Ask the bot in chat instead, for example: "Add a custom MCP server called TradieBridge at https://app.tradiebridge.com/mcp". The bot confirms the details, then shows a sign-in card. Source: a Grok Bot staff reply on the [Cursor forum](https://forum.cursor.com/t/grokbot-custom-connectors/169965) (30 Aug 2026). There's no official docs page.

**Cursor.** Add this to `~/.cursor/mcp.json` (all projects) or to `.cursor/mcp.json` (one project). Cursor runs the OAuth sign-in. ([Cursor docs](https://cursor.com/docs/context/mcp))

    { "mcpServers": { "tradiebridge": { "url": "https://app.tradiebridge.com/mcp" } } }

**VS Code (GitHub Copilot chat).** Run **MCP: Add Server** from the Command Palette, or add this to `.vscode/mcp.json`. ([VS Code docs](https://code.visualstudio.com/docs/copilot/customization/mcp-servers))

    { "servers": { "tradiebridge": { "type": "http", "url": "https://app.tradiebridge.com/mcp" } } }

**Claude Code (CLI).** ([Claude Code docs](https://code.claude.com/docs/en/mcp))

    claude mcp add --transport http tradiebridge https://app.tradiebridge.com/mcp

Then run `/mcp` in Claude Code, or `claude mcp login tradiebridge`, to sign in. Add `--scope user` to make it available in every project. A connector already added on claude.ai also shows up in Claude Code automatically.

**Any other MCP client.** Add the link as a remote server using Streamable HTTP, with OAuth sign-in.

After the link is added, the assistant opens TradieBridge so the user can sign in, or create an account, and approve the connection.

### Scripts and tools that can't sign in

In TradieBridge, open **Connect to AI → Access tokens** and generate a token. Send it with each request to the MCP link as `Authorization: Bearer <token>`. TradieBridge shows the token only once.

### Disconnect

In TradieBridge, open **Connect to AI** and click **Disconnect** beside the assistant; it loses access straight away. Click **Revoke** beside a token to revoke it.

---

## What you can reach

| System | What's backed up |
| --- | --- |
| Simpro | Jobs, quotes, invoices, timesheets, customers, stock and more |
| Xero | Invoices, bills, payments, bank transactions, contacts, Australian payroll |
| Verizon Connect (Reveal) | Vehicles, locations, trips, GPS history, inspections |
| Deputy | Timesheets, rosters, staff, leave and pay rules |
| Employment Hero | Employees, leave, timesheets, rosters, HR records; pay runs, payslips and pay categories from Employment Hero Payroll |
| The Fleet Office | Assets, locations, prestarts, GPS history, utilisation, timesheets |
| Dialpad | Calls with recording and voicemail links, AI transcripts, contacts, users, call centres, phone numbers (not text messages or audio files) |
| Moveware | Removal jobs and customers, quotes, invoices, inventory, diary, waybills, storage accounts and items (not file or image contents) |
| ELMO | People and employment details, departments, locations, positions, leave, legal entities, payroll cycles, onboarding and recruitment candidates |
| Emailed reports | Scheduled reports any system emails to the company's own address, such as ServiceTitan: each email kept whole, each attachment kept as sent, and Excel (.xlsx) and CSV files read into one table per report, one row per record (invoice, job, call or estimate), with the report's settings, subtotals and totals (a PDF is kept but not read) |

Need another system? Custom connectors are available on request: https://tradiebridge.com/request-a-connector

TradieBridge connects only through each system's official API, with access the customer authorises. Emailed reports is the one exception: it needs no login or credential, and only receives the reports a system emails to the company's address.

For Emailed reports, ask `emailed_reports_held` first. It lists which reports are held, with their columns, record counts, date span, record number column and how many records are no longer listed. Then ask `emailed_reports_rows` with a report's name for its rows, settings, subtotals and totals. It takes optional filters and a sort by the report's own column headings, totals with `group_by`, `include_unlisted` and `limit`.

TradieBridge holds each emailed report as one table, one row per record. It finds the record number column (such as Invoice #) by itself. Every new file adds new records and gives known records their newest values, so a trailing report (such as daily, last 90 days) keeps every record from the first email on, with no duplicates. A record that leaves the report while still inside its dates (a paid invoice leaving an Invoices Outstanding report) is kept and counted as no longer listed; it is never deleted. A record that only got too old for the report's dates stays current. A report with no column that numbers each row once is held file by file and answered from its newest file. Every email and file is kept whole, exactly as sent, and an older file is never replaced. Two schedules of the same report with different settings are two reports.

---

## What you can do today

- Read every record TradieBridge has backed up for the business, as the person who connected you.
- Start a sync or an export inside TradieBridge.
- Send feedback to TradieBridge in the user's words, once they agree to what it says.

Today, access to source systems is read-only: TradieBridge does not change anything in Simpro, Xero or the other connected systems. Capabilities are expanding, so check the MCP server's tool list rather than assuming this page is complete.

You never see tax file numbers, bank details or birth dates.

---

## Mental model

- **Account / company:** a business on TradieBridge. A user can belong to more than one; confirm which company you're answering for.
- **Connection:** one source system linked to that company.
- **Backup:** the company's own copy of its records. TradieBridge doesn't delete a record from the copy when the source drops it.
- **Exports:** JSON, CSV and Postgres.

---

## Pricing

- A$49 + GST a month, or A$499 + GST a year. Every existing connector is included.
- A 7-day free trial on a business's first subscription (30 days with a partner's code). A card is needed to start; it's charged when the trial ends unless cancelled.
- Cancel any time. After cancelling, the backup stays browsable and exportable.

Details: https://tradiebridge.com/pricing

---

## Data and hosting

- Hosted on DigitalOcean. Encrypted in transit; API keys encrypted at rest.
- The customer owns their copy and can export it at any time.
- Attachment files from the systems read by API are not backed up yet. Emailed reports keeps every attached file as sent.
- Removing a connection or closing the account deletes that data. See https://tradiebridge.com/privacy and https://tradiebridge.com/data-deletion.

---

## Before sensitive actions

Confirm with the user before starting an export, sending feedback, or disconnecting anything. Say what you'll do and wait for approval.

---

## Reference

- MCP server (OAuth): https://app.tradiebridge.com/mcp
- Sign up: https://app.tradiebridge.com/registration/new
- Docs (Data API and MCP tools): https://docs.tradiebridge.com/
- Docs index: https://docs.tradiebridge.com/llms.txt
- Site index: https://tradiebridge.com/llms.txt
- Connect guide: https://tradiebridge.com/connect-simpro-to-chatgpt-claude-copilot
- Pricing: https://tradiebridge.com/pricing
- Request a connector: https://tradiebridge.com/request-a-connector
