Assistants

On this page: What connecting means · The sign-in page · What an assistant can do · Approvals · The ready-made requests · Good asks · Rules for assistants · Manage and troubleshoot

LazyJack opens your boat's record to an AI assistant through MCP (Model Context Protocol). You give the assistant one address, sign in to LazyJack once on LazyJack's own page, and approve what it may do. From then on the assistant can read the record and change it, in a chat, by voice, or from a tool on your computer, and everything it does appears in the app like your own changes.

This chapter explains what connecting means, what an assistant can and cannot do, and how to work with one well. The step-by-step for a particular assistant (ChatGPT, Claude, Claude Code, Cursor, VS Code) is the assistant guide.

What connecting means

The address	`https://app.lazyjack.app/api/v1/mcp`
Who can connect	The boat's owner, signed in with the LazyJack email and password on LazyJack's page. The assistant never sees them.
What is needed first	A boat set up in LazyJack. An account with no boat cannot be connected.
How long it lasts	A connection stays valid for 90 days of use, or until you revoke it.
Where it is listed	Account, Assistants: each connection, its permissions, when it was connected and last used, and Revoke.

The address is the same for every assistant and is shown on the Account page with a Copy button. Any assistant that supports MCP with OAuth sign-in can use it; no key or secret is typed anywhere.

An assistant that cannot sign in by itself can be given a token made by hand (Account, Assistants, "Advanced: create a token by hand"). That token never expires, so revoke it when you stop using it. It is also the only way to make a read-only connection: untick "Allow create and update".

Nothing is connected until you approve on LazyJack's own page. It shows:

The name the assistant gave itself, and, for one that registered itself (every assistant does, apart from a few LazyJack knows), "LazyJack has not verified it". Continue only if you started this connection yourself a moment ago. Anyone can register an app called "Claude".
Exactly what it gets, as a headline ("See everything on the boat", "Add and change records", and only if asked for, "Archive, restore or delete records") and one line per area, "See" or "See and change": Boat details, Your profile, Equipment and engine hours, Documents, Uploaded files, Work: plans and jobs, Projects, Expenses and the budget, Trips and the log, Problems, Checklists, Today's readiness summary, People, Places, Tell someone (float plans), Inventory and To buy.
Where you will be returned: claude.ai, chatgpt.com, or your own computer for a tool there. If that is not the assistant you are using, close the page.

What an assistant can do

With the usual permissions (see and change), an assistant can read and change every kind of record in the app, with the same checks you get: a reading may not be lower than the one before, a change to a record someone else changed since is refused, an amount must be in the boat's currency.

Can, with see and change	Read and update the boat's details, equipment, engine hours, jobs, plans and problems, trips and the log, documents and files, items, stock and the shopping list, checklists, people, places, projects and expenses; read Today's summary, the work queue and the budget forecast; start, tick and complete a checklist; log a trip in one call with its readings and problems; mark a job done with its cost and items used.
Only with the extra permission, and your approval each time	Archive, restore or delete anything; detach a document; undo a stock entry; remove engine hours from an engine.
Never	Download or restore a backup, clear the boat's data, delete your account, see or change other connections, approve its own requests, change what it may do.

Each change an assistant makes is in the activity list on Today and on the Account page, and it syncs to your devices within a minute like any other change. A stock entry made by an assistant says "by <its name>" in the item's stock history.

Approvals

An assistant's request to archive, restore or delete waits for you.

The assistant asks; LazyJack answers that the change needs approval and keeps the request.
The request appears on the Account page under Assistants, Pending requests, saying what it would do. It also appears there without a refresh.
You Approve it. A request you do not approve within 15 minutes expires; there is no Reject button.
After approving, ask the assistant to try again. The retried call goes through; a different call (another record, other values) needs its own approval.

A connection without the archive permission simply has those requests refused. ChatGPT and Claude do not ask for it when they connect.

The ready-made requests

An assistant that supports MCP prompts shows these in its menu. Each is a complete request in LazyJack's words, naming what to read, what to ask you first, and what never to do. They grant nothing: the tools still check the permissions above.

Request	What it does
Before my next trip	Reads the next planned trip, Do first, the papers and equipment dates falling before it, the departure checklist and the kit, and offers to start the checklist.
Log a trip	Asks everything in one message (from, to, when, who, engine hours per engine, anything wrong), shows a summary, and on your yes records it as one trip.
Go through what's outstanding	Walks Do first and Soon one item at a time, offering done, not now or leave for a job, and schedule a fix, keep watching or mark fixed for a problem. One record per answer.
Something's wrong	Records a problem against the equipment it concerns, asks whether it is urgent, then whether to schedule a fix.
I did a job	Finds the open job, asks the engine hours, the cost, who was paid and the items used, and marks it done, saying when the next one is due.

Good asks

An assistant is at its best when you give it what you know and let it find the rest.

"What should I do first on the boat?"
"Log today's sail from Hankø to Son, back at 16:30, engine now 2,491 hours. The bilge pump ran more than usual."
"Add an impeller to the shopping list, part number 09-1027B."
"Which papers expire before June?"
"I changed the engine oil and filter today at 2,500 hours, used the oil and filter from stock, paid 1,250 to Marineservice."
"Here is the order confirmation from the chandlery" (pasted): the assistant matches each line to an item, adds the order, and later records the receipt against it.
"What did I spend on the boat in 2025?"
"Pause the winter plans."

Asks that go badly: "tidy up my records" (it will want to archive things, which needs your approval each time, and tidiness is a judgement you should make); "is the boat ready to sail" (it is told never to answer that; it will tell you what the record reports).

Rules for assistants

If you are an assistant connected to LazyJack, these are the rules the owner expects you to follow. The ready-made requests state them; they apply to every call.

Use the app's words with the owner: trip, equipment, reading, job, plan, problem, item, kit, document, place, person, checklist, project, expense. The tool names use older words (voyage, defect, waypoint, crew, inventory_item, maintenance_task); do not say them to the owner.
Never archive, delete or purge anything, and never cancel a trip or a checklist, unless the owner asks for exactly that. Those calls need approval anyway; do not ask for it unprompted.
Never say the boat is safe, ready or seaworthy. Report what the records show: readiness_get and work_list give Do first and Soon. "Nothing is reported" is the most you may say.
Read before you write. Fetch the record (*_get) to have its current version, and send expectedVersion. A refusal with code version-conflict carries currentVersion: read again, show the owner what changed, then retry if they still want the change.
Confirm before changing, one record per answer. Show a short summary and wait for yes. Do not change several records on one answer unless the owner asked for a batch (an order confirmation with many lines is such a case).
Make a change once. Every create tool takes a requestKey; send one your retry would send again ("<shop>-<order number>-<line>"), so a repeated call answers repeated: true with the stored record instead of making a second one. Several changes in one request: batch_call, each entry with its own requestKey.
Amounts are in the boat's one currency (vessel_get gives it). A price in another currency is refused; convert it with the owner or leave the amount out and keep the quote in notes.
Engine hours are readings, never notes. Record them with reading_record (or inside voyage_complete and maintenance_task_complete), never in a log entry's text. A reading may not be lower than the latest accepted one.
Something wrong is a problem, defect_create against the equipment, never a change to the equipment's status or condition.
Match before you create. inventory_item_match, equipment_list and search find what exists. A create that looks like a duplicate answers with warnings; read them to the owner before going on.
A refused call carries a code (invalid-argument, forbidden, not-found, conflict, version-conflict, too-large, rate-limited) and a sentence in plain words. Tell the owner the sentence; do not retry forbidden or invalid-argument unchanged.
Large lists take limit, offset and fields. Ask for what you need.
Documents attach to records (document_attach, or attachedTo on create). Detaching needs approval; attaching does not.

Manage and troubleshoot

What you see	What it means	What to do
The assistant asks you to sign in again	Its sign-in ran out (90 days) or was revoked	Sign in again on LazyJack's page
A change "needs approval"	It would archive, restore or delete, and the connection has that permission	Approve it under Account, Assistants, Pending requests within 15 minutes, then ask the assistant to try again
"Not verified" beside a connection	The assistant registered itself; LazyJack cannot vouch for the name it chose	Expected for ChatGPT and Claude. Revoke anything you did not connect yourself
"This account has no vessel yet."	The account has no boat	Set up the boat in the app first
"Too many requests. Try again in N seconds."	One connection made more than 600 requests in ten minutes	Wait; the assistant should slow down
Connected, but the assistant sees no tools	The permissions it asked for cover none of LazyJack's tools	Revoke and connect again
A change the assistant made is wrong	It was recorded like any change	Correct it in the app: a reading is voided and re-recorded, a stock entry undone, a record edited or archived

Not in this chapter

Connecting a specific assistant, menu by menu: the assistant guide. What the app's own words mean and how its records behave: How LazyJack thinks. The exact permission names a connection holds: Account, Assistants, "Show exact permissions" on the connection.

This chapter as Markdown · llms.txt