Connect your own AI agent as an AI Apprentice

GarageManager does not supply the AI. You connect your own AI agent as an apprentice, with a token you create: any AI agent that can connect to an MCP server over HTTP with a bearer token, or call a REST API, such as Claude Code. It looks things up and preps drafts. A person in your workshop signs off every draft it preps, and only a person issues or sends anything to a customer.

Connect in four steps

  1. In Settings, open AI Apprentice and choose Take on an AI Apprentice. Whoever can change your workshop's settings can do this; on a paid plan or a trial, that is an owner.
  2. Name it, choose Read only or Read and draft (an owner can also choose Read, draft and manage the Library), and choose when its access ends: 30 days, 90 days or never.
  3. Copy the token. It is shown once. Then connect your agent with one of the forms below.
  4. When it preps a quote or an invoice, choose Awaiting sign-off on the Quotes or Invoices list and open the draft with Review. Check the lines and the total, then sign it off. Signing off sends nothing; issuing and sending stay with you.

Pick the app your agent lives in

Claude Code

  1. Set GM_AGENT_TOKEN to your token, then run this in your terminal on macOS or Linux.
  2. Open Claude Code and ask it to look up a customer.
Terminal (macOS or Linux)
claude mcp add --transport http garagemanager 'https://app.garagemanager.co.za/api/agent/mcp' \
  --header "Authorization: Bearer $GM_AGENT_TOKEN"

Running this saves the token in Claude Code's own settings, in plain text. To keep it only in your environment, use the .mcp.json form under Other instead.

Claude and Claude Code are trademarks of Anthropic. OpenAI, ChatGPT and Codex are trademarks of OpenAI. Icons are the companies' own published files, unmodified. GarageManager is not affiliated with Anthropic or OpenAI.

If your agent says the GarageManager server needs authentication, the token was mistyped, has expired or was revoked. Revoke it in Settings, AI Apprentice, and take on a new AI Apprentice.

What it can do

Each action, as your agent sees it. Read only covers looking things up; Read and draft adds customers, job cards and drafts; Read, draft and Library also keeps your Library.

  • workshop.get

    MCP tool: workshop_get

    Every AI Apprentice

    Describe the workshop this token belongs to: name, VAT status, currency, plan, and how much of any plan limit is used.

    Full description

    Describe the workshop this token belongs to: name, VAT status, currency, plan, and how much of any plan limit is used. Call this first.

  • clients.list

    MCP tool: clients_list

    Every AI Apprentice

    List the workshop's customers, newest first.

    Full description

    List the workshop's customers, newest first. Optional search matches name, email, phone or customer number.

  • clients.get

    MCP tool: clients_get

    Every AI Apprentice

    Get one customer by id.

  • clients.create

    MCP tool: clients_create

    Read and draft

    Add a customer.

    Full description

    Add a customer. name and email are required; the email must not belong to another customer of this workshop (a duplicate answers conflict, with the existing customer id in issues). The Free plan holds up to 5 customers. Nothing is sent to the customer. Send an idempotencyKey to make a retry safe.

  • clients.update

    MCP tool: clients_update

    Read and draft

    Change a customer's details.

    Full description

    Change a customer's details. Only the fields you send change; send null to clear phone, whatsappNumber, address or businessRegNumber. The email and the customer number cannot be changed here: email changes are made by staff in the dashboard. Nothing is sent to the customer.

  • vehicles.list

    MCP tool: vehicles_list

    Every AI Apprentice

    List vehicles, newest first.

    Full description

    List vehicles, newest first. Filter by customer id or by registration plate (partial match).

  • vehicles.get

    MCP tool: vehicles_get

    Every AI Apprentice

    Get one vehicle by id.

  • vehicles.create

    MCP tool: vehicles_create

    Read and draft

    Add a vehicle to one of the workshop's customers.

    Full description

    Add a vehicle to one of the workshop's customers. make, model and registrationPlate are required. A plate already on this account (ignoring letter case) answers conflict with the existing vehicle id in issues. Nothing is sent to the customer.

  • vehicles.update

    MCP tool: vehicles_update

    Read and draft

    Correct a vehicle.

    Full description

    Correct a vehicle. Only the fields you send change; send null to clear year, vin, engineNumber or odometerKm. A vehicle cannot be moved to another customer.

  • jobcards.list

    MCP tool: jobcards_list

    Every AI Apprentice

    List job cards, newest first.

    Full description

    List job cards, newest first. Filter by status or customer id.

  • jobcards.get

    MCP tool: jobcards_get

    Every AI Apprentice

    Get one job card by id, with its line items.

  • jobcards.create

    MCP tool: jobcards_create

    Read and draft

    Open a job card for a customer, BOOKED_IN, with an optional vehicle (it must be that customer's), notes and lines.

    Full description

    Open a job card for a customer, BOOKED_IN, with an optional vehicle (it must be that customer's), notes and lines. Each line needs a serviceName or a description, a quantity above 0, a unitPrice of 0 or more and an itemType (PART, LABOUR or OTHER). Nothing is sent to the customer.

  • jobcards.update

    MCP tool: jobcards_update

    Read and draft

    Change a job card's notes (send null to clear them).

    Full description

    Change a job card's notes (send null to clear them). Refused once the card is INVOICED or CANCELLED. The status cannot be changed.

  • jobcards.set_items

    MCP tool: jobcards_set_items

    Read and draft

    Replace a job card's lines with the list you send (an empty list removes them all).

    Full description

    Replace a job card's lines with the list you send (an empty list removes them all). Refused once the card is INVOICED or CANCELLED. Does not change the status. Replacing the lines detaches the service-library pins of every replaced line (each pin keeps a snapshot of its line).

  • quotes.list

    MCP tool: quotes_list

    Every AI Apprentice

    List quotes, newest first.

    Full description

    List quotes, newest first. Filter by status or customer id.

  • quotes.get

    MCP tool: quotes_get

    Every AI Apprentice

    Get one quote by id, with its line items.

  • quotes.create_draft

    MCP tool: quotes_create_draft

    Read and draft

    Prepare a draft quote for one of the workshop's customers and one of that customer's vehicles.

    Full description

    Prepare a draft quote for one of the workshop's customers and one of that customer's vehicles. The workshop's own totals and VAT rule are applied. The quote waits for a person to sign it off before it can be sent; read awaitingSignOff with quotes.get for its current state (a repeat with the same idempotency key returns the first response, not the current one). Each line needs serviceName, a quantity above 0 and a unitPrice of 0 or more (rands, at most two decimals); itemType (PART, LABOUR, OTHER, CALLOUT), description, catalogItemId and parentServiceCatalogItemId are optional.

  • quotes.update_draft

    MCP tool: quotes_update_draft

    Read and draft

    Change a draft quote your AI Apprentice prepared, while it is still a DRAFT.

    Full description

    Change a draft quote your AI Apprentice prepared, while it is still a DRAFT. Sending lines replaces them all. Any change clears an earlier sign-off, so a person must sign it off again. Each line needs serviceName, a quantity above 0 and a unitPrice of 0 or more (rands, at most two decimals); itemType (PART, LABOUR, OTHER, CALLOUT), description, catalogItemId and parentServiceCatalogItemId are optional.

  • invoices.list

    MCP tool: invoices_list

    Every AI Apprentice

    List invoices, newest first.

    Full description

    List invoices, newest first. Filter by status or customer id. outstanding: true returns invoices still awaiting payment, using the same rule as the dashboard. Archived invoices are left out unless includeArchived is true.

  • invoices.get

    MCP tool: invoices_get

    Every AI Apprentice

    Get one invoice by id, with its line items.

  • invoices.create_draft

    MCP tool: invoices_create_draft

    Read and draft

    Prepare a draft invoice for one of the workshop's customers and one of that customer's vehicles, with its lines.

    Full description

    Prepare a draft invoice for one of the workshop's customers and one of that customer's vehicles, with its lines. The Free plan allows 5 invoices a month. The invoice waits for a person to sign it off before it can be issued, sent or paid; read awaitingSignOff with invoices.get for its current state (a repeat with the same idempotency key returns the first response, not the current one). Each line needs serviceName, a quantity above 0 and a unitPrice of 0 or more (rands, at most two decimals); itemType (PART, LABOUR, OTHER, CALLOUT), description, catalogItemId and parentServiceCatalogItemId are optional. Totals and VAT are computed by the workshop, never taken from you.

  • invoices.update_draft

    MCP tool: invoices_update_draft

    Read and draft

    Change a draft invoice your AI Apprentice prepared, while it is still a DRAFT.

    Full description

    Change a draft invoice your AI Apprentice prepared, while it is still a DRAFT. Sending lines replaces them all; an odometer you do not send is left as it is. Any change clears an earlier sign-off. Each line needs serviceName, a quantity above 0 and a unitPrice of 0 or more (rands, at most two decimals); itemType (PART, LABOUR, OTHER, CALLOUT), description, catalogItemId and parentServiceCatalogItemId are optional. Totals and VAT are computed by the workshop, never taken from you.

  • catalog.list

    MCP tool: catalog_list

    Every AI Apprentice

    List the workshop's Library of services, parts and labour with default prices.

    Full description

    List the workshop's Library of services, parts and labour with default prices. Archived items are left out unless includeArchived is true (Library access only). Cost price and supplier are shown only with Library access.

  • catalog.get

    MCP tool: catalog_get

    Every AI Apprentice

    Get one Library item by id, archived items included.

    Full description

    Get one Library item by id, archived items included. Cost price and supplier are shown only with Library access.

  • catalog.create

    MCP tool: catalog_create

    Read, draft and Library

    Add one item to the Library: name (required), description, selling price, kind, labour code, standard hours, labour category, cost price and supplier.

    Full description

    Add one item to the Library: name (required), description, selling price, kind, labour code, standard hours, labour category, cost price and supplier. Names are unique in the workshop, archived items included; a labour code must not be used by another item that is not archived. labourCategory must be one of the listed codes whatever the kind (an unknown one is refused, not ignored). Changes to a selling price, or to the standard hours on a LABOUR item (a labour line is priced as hours times the labour rate), apply to new quotes and invoices only, and at most 100 items can have them changed per workshop in any 24 hours.

  • catalog.update

    MCP tool: catalog_update

    Read, draft and Library

    Change any fields of one Library item.

    Full description

    Change any fields of one Library item. A kind change away from LABOUR clears its labour code, hours and category. A name may be at most 120 characters and a description 2000; an item that already has a longer one keeps it unless you change it. Send ifUnchangedSince (the item's updatedAt from catalog_list or catalog_get) so a change someone made since you read it is not overwritten. Changes to a selling price, or to the standard hours on a LABOUR item (a labour line is priced as hours times the labour rate), apply to new quotes and invoices only, and at most 100 items can have them changed per workshop in any 24 hours. For a part, stock settings go in `stock`: trackStock (true needs openingQuantity, how many are on the shelf now; false stops tracking and keeps its history), stockUnit (EACH, LITRE, METRE or KG) and reorderLevel (null for no low-stock alert). An opening quantity counts as one stock line toward the daily stock limit. A part that tracks stock cannot change kind: stop tracking first.

  • catalog.archive

    MCP tool: catalog_archive

    Read, draft and Library

    Archive one Library item.

    Full description

    Archive one Library item. It stays in history and on every quote and invoice that used it, and can be restored with catalog_restore. Nothing is ever deleted.

  • catalog.restore

    MCP tool: catalog_restore

    Read, draft and Library

    Restore one archived Library item.

    Full description

    Restore one archived Library item. Refused if another item that is not archived now uses its labour code. It comes back with the price it had, which does not count toward the price limit; check it is still right.

  • catalog.merge

    MCP tool: catalog_merge

    Read, draft and Library

    Merge duplicate Library items: optionally change the item to keep (keeperChanges), then archive 1 to 20 duplicates, all in one step.

    Full description

    Merge duplicate Library items: optionally change the item to keep (keeperChanges), then archive 1 to 20 duplicates, all in one step. Quote, invoice and job card lines keep pointing at the duplicate they used. Part links on the duplicates are not moved: partLinksLeft says how many to re-link. The keeper cannot take a duplicate's name, because archived items keep their names. Send ifUnchangedSince (the item's updatedAt from catalog_list or catalog_get) so a change someone made since you read it is not overwritten. Changes to a selling price, or to the standard hours on a LABOUR item (a labour line is priced as hours times the labour rate), apply to new quotes and invoices only, and at most 100 items can have them changed per workshop in any 24 hours.

  • catalog.update_many

    MCP tool: catalog_update_many

    Read, draft and Library

    Change 1 to 50 Library items in one step.

    Full description

    Change 1 to 50 Library items in one step. All or nothing: if any item is refused, nothing changes and the error names its index and id. Send ifUnchangedSince (the item's updatedAt from catalog_list or catalog_get) so a change someone made since you read it is not overwritten. Changes to a selling price, or to the standard hours on a LABOUR item (a labour line is priced as hours times the labour rate), apply to new quotes and invoices only, and at most 100 items can have them changed per workshop in any 24 hours.

  • catalog.archive_many

    MCP tool: catalog_archive_many

    Read, draft and Library

    Archive 1 to 100 Library items in one step.

    Full description

    Archive 1 to 100 Library items in one step. All or nothing. Items already archived are reported as unchanged.

  • catalog.restore_many

    MCP tool: catalog_restore_many

    Read, draft and Library

    Restore 1 to 100 archived Library items in one step.

    Full description

    Restore 1 to 100 archived Library items in one step. All or nothing. Each comes back with the price it had, which does not count toward the price limit.

  • stock.list

    MCP tool: stock_list

    Every AI Apprentice

    List the parts that track stock: quantity in stock, unit, reorder level, whether each is low or out, and how many are on open job cards.

    Full description

    List the parts that track stock: quantity in stock, unit, reorder level, whether each is low or out, and how many are on open job cards. Send filter "low" for only the parts at or below their reorder level, or out.

  • stock.history

    MCP tool: stock_history

    Every AI Apprentice

    Read one part's stock movements, newest first: type, quantity, balance after, reason, note, invoice number, who and when.

    Full description

    Read one part's stock movements, newest first: type, quantity, balance after, reason, note, invoice number, who and when. Unit cost and supplier are shown only with Library access.

  • stock.receive

    MCP tool: stock_receive

    Read, draft and Library

    Receive a supplier delivery into stock: supplier, the supplier invoice or delivery note number, and one line per part with the quantity received and, optionally, the unit cost and whether to update the part's cost price to it.

    Full description

    Receive a supplier delivery into stock: supplier, the supplier invoice or delivery note number, and one line per part with the quantity received and, optionally, the unit cost and whether to update the part's cost price to it. Send a receiptKey (16 to 64 letters, digits, - or _) to make a retry safe: the same delivery with the same key is not received twice, and a different delivery with that key is refused. Every line must be a part of this workshop that tracks stock and is not archived; one line that is not refuses the whole call and names its index. At most 50 lines per call and 100 stock lines per workshop in any 24 hours, across all your AI Apprentices; a call that would go past that is refused whole. Each line is at most 10 000 in the part's unit, with at most 2 decimals.

  • stock.adjust

    MCP tool: stock_adjust

    Read, draft and Library

    Adjust stock with a reason: a positive quantity adds, a negative one removes.

    Full description

    Adjust stock with a reason: a positive quantity adds, a negative one removes. Reasons: DAMAGED, LOST, USED_IN_WORKSHOP, RETURNED_TO_SUPPLIER, FOUND, CORRECTION, OTHER. A note is required on every line, saying why. Every line must be a part of this workshop that tracks stock and is not archived; one line that is not refuses the whole call and names its index. At most 50 lines per call and 100 stock lines per workshop in any 24 hours, across all your AI Apprentices; a call that would go past that is refused whole. Each line is at most 10 000 in the part's unit, with at most 2 decimals. A full stock count is not available to an AI Apprentice: a person counts the shelf.

  • reports.summary

    MCP tool: reports_summary

    Every AI Apprentice

    The workshop's headline figures, computed by the same function as the dashboard: money awaiting payment, money overdue, average invoice value and invoice count.

  • actions.list

    MCP tool: actions_list

    Every AI Apprentice

    List every action this token may call, with the permission each one needs.

Managing your Library

Only an owner can give an AI Apprentice Library access, by choosing "Read, draft and manage the Library" when taking it on. An apprentice that already exists cannot gain it: take on a new one.

Library access stops at the apprentice's next request if the owner who granted it is no longer an active owner (demoted or deactivated), and comes back if they are an active owner again. Reading and preparing drafts keep working.

It can add and edit items, including cost price and supplier, archive and restore them, and merge duplicates. It never deletes an item, and an archived item can always be restored.

Merging keeps one item and archives the duplicates. Quotes, invoices and job cards keep pointing at the item they used, and links between services and parts stay on the archived duplicates, so re-link them if you rely on suggested parts.

At most 100 selling prices and labour times can change in any 24 hours, across all your AI Apprentices together. A labour time counts because a labour line is priced as its standard hours times your labour rate. A request that would go past that is refused whole, and changes can carry on as earlier ones pass 24 hours. Edits that change no selling price or labour time carry on.

A new price reaches new quotes and invoices only. Existing ones keep their prices and totals. A new cost price is picked up by a draft quote or invoice the next time its lines are saved; issued invoices never change.

Restoring an archived item brings back the price it had when it was archived, and a merge keeps the price of the item it keeps. Neither changes a price, so neither counts toward the limit; check a restored item's price before your staff pick it.

If someone else may be editing the same item, the apprentice can send the item's updatedAt as ifUnchangedSince: if the item changed since it read it, nothing is overwritten and it is asked to read it again.

Read only and Read and draft apprentices can look up items and prices, but not cost price or supplier.

Stock: any AI Apprentice can look up stock levels and a part's stock history. With Library access it can also receive deliveries, adjust stock with a reason and a note on every line, and turn stock tracking on or off for a part, up to 50 lines a request and 100 stock lines in any 24 hours across all your AI Apprentices together. It never counts stock, and a draft it prepares moves stock only when someone in your workshop issues it.

What it cannot do

  • Issue, send or resend anything to a customer.
  • Record, change or refund a payment.
  • Sign off a draft, its own included. A person in your workshop does that.
  • Cancel or delete a customer, vehicle, job card, quote, invoice or Library item. Replacing lines does remove the old lines: jobcards.set_items, quotes.update_draft and invoices.update_draft each replace every line of the job card or draft they change.
  • Change a job card's status.
  • Edit a quote or invoice that is no longer a draft, or a draft a person created.
  • Change a customer's email address. Your staff change it in GarageManager.
  • Change settings, team, branding or billing.

Limits and records

  • Up to 10 active AI Apprentices per workshop.
  • Up to 1 000 requests an hour for each one.
  • Settings, AI Apprentice keeps a record of each action an AI Apprentice runs or tries while it has access, refused ones included.
  • Anything that would go past your plan's limits, such as its number of customers or of invoices a month, is refused, and the record shows “Refused: plan limit reached”.
  • Past the limit on Library price changes in any 24 hours, the record shows “Refused: daily price-change limit reached”.
  • When a trial ends without a plan, it can still look things up, but it cannot add, change or prep anything until a plan is chosen. The record shows “Refused: trial ended”.
  • Revoking it, or its access running out, stops it at its next request.

Back to the Help Center