Before you start

  • You need a kepd account. Connected apps are on every plan and cost nothing extra; the AI app is your own subscription with Claude, ChatGPT, Grok or Cursor.
  • The business's Owner switches connected apps on in kepd: Settings, then Connected apps. They are off until the Owner does.
  • You need to be allowed to connect. Owners and Admins are by default; the Owner can choose person by person in Settings, Connected apps, Who can connect.

The server URL

Every app connects to the same address: https://api.kepd.app/mcp

Add kepd to your app

  • Claude (claude.ai, Desktop and mobile): Settings › Connectors › Add custom connector. Paste the server URL, then sign in to kepd when asked.
  • ChatGPT: Settings › Apps and Connectors › Advanced settings. Turn on Developer mode and choose Create. Paste the server URL, choose OAuth, then sign in to kepd.
  • Grok (grok.com): Connectors › New connector › Custom. Paste the server URL, then sign in to kepd.
  • Cursor: Settings › MCP › Add new MCP server. Add kepd like this:
    {
      "mcpServers": {
        "kepd": {
          "url": "https://api.kepd.app/mcp"
        }
      }
    }
  • Claude Code: Run this in your terminal:
    claude mcp add --transport http kepd https://api.kepd.app/mcp

When the app asks you to sign in, you sign in to kepd as usual (with your two-factor code if you use one) and choose what the app may do: look things up only, or look things up and make changes. Only office admins can allow changes; everyone else, technicians included, connects to look things up.

Things to ask

  • “What's on for the team tomorrow?”
  • “How much are clients owing, and what's overdue?”
  • “Which quotes haven't been opened yet?”
  • “Compare October with September.”
  • “Book a visit on JOB-10852 for Thursday 9 to 11 with Dean.”
  • “Text the client on REQ-1144 that we're running 20 minutes late.”

What it can look up

  • Search clients, sites and jobs, and open any request, quote, job or invoice
  • Business figures: quoted, invoiced, owing and received, worked out by kepd rather than the AI
  • Compare this month with last, or with last year
  • Your team's day, schedule conflicts, a day's run, and busy or quiet weeks ahead
  • Loose ends: quotes not followed up, jobs not invoiced, invoices overdue
  • Prices from your price list, and your own work for any day
  • Anything else you can see in kepd's web app: reports, timesheets, clients and sites, compliance, marketing and settings

It can't use the client portal or act as the kepd Field app (clocking on and off, breaks, location), and it can't change roles, two-factor or security settings, your kepd subscription, or connect integrations. It sees only what your role in kepd sees. A technician's app sees their own work, and a role that can't see prices gets no prices.

What it can change straight away

  • Create a request, and update a case's details
  • Update the same detail on several cases at once
  • Book or cancel a visit, and assign work to your team
  • Place a site's pin on the map, for a new estate or rural lot no address search can find

What waits for your OK

  • Sending a quote or invoice, or texting a client
  • Emailing a client about a booking
  • Creating a quote, job or invoice, or moving a case to its next stage, because each takes a document number
  • Adding lines to a quote or changing its discount
  • Issuing, voiding or deleting an invoice, and recording a payment
  • Any other change you could make in kepd's web app, which the app asks for through kepd and you see in full before approving

The app can ask, but nothing happens until you say yes. When you connect, you choose where: in the app itself, where it asks you in the chat and you approve without leaving it, or in kepd only, from the bell on the web, the notification on your phone, or Settings, then Connected apps. A request you don't answer within five minutes lapses.

If you approve in the app, keep the app's own "allow" prompt switched on for kepd's approve tool. That prompt is what stops the AI approving by itself, for example after reading a client note or an email that tries to talk it into sending something. Choose "in kepd only" and the AI can never approve.

Every tool, and what it does

These are the tools kepd's server gives an app, exactly as the app lists them. What a connection gets depends on the person's role and the access they chose when connecting.

Look things up

Read-only. Every connection, within what the person's role can see.

  • search_org Search clients, sites and jobs
  • list_cases List requests, quotes, jobs or invoices
  • get_case Open a case
  • get_figures Business figures, worked out by kepd
  • find_invoices Find invoices
  • find_price Find a price on the price list
  • compare_periods Compare two periods
  • check_team_today Check the team's day
  • workload_outlook Workload outlook
  • find_loose_ends Find loose ends
  • find_schedule_conflicts Find schedule conflicts
  • analyse_day Analyse a day's run
  • get_my_work Get my work
  • find_address_at Find the address at a point
  • find_kepd_action Find a kepd action (kepd's own API, documented at api.kepd.app/docs)
  • kepd_read Read from kepd's API

Changes that run straight away

A connection allowed to make changes. They reach nobody outside kepd.

  • create_work_item Create a request (a quote, job or invoice waits for approval)
  • update_work_item Update a case
  • schedule_visit Book a visit (emailing the client about it waits for approval)
  • cancel_visit Cancel a visit
  • assign_work_items Assign work
  • bulk_update_work_items Update several cases
  • set_site_pin Place a site's pin

Changes that always wait for your OK

Nothing happens until the person approves it, in kepd or in the app if they chose that.

  • send_document Send a quote to the client
  • send_sms Text a client
  • issue_invoice Issue an invoice
  • email_invoice Email an invoice or a reminder
  • send_invoices Send several invoices at once
  • void_invoice Void an invoice
  • delete_invoice Delete an invoice
  • record_invoice_payment Record a payment received (it moves no money)
  • add_quote_lines Add quote lines
  • set_quote_discount Set a quote discount
  • convert_stage Move a case to its next stage
  • bulk_convert_stage Move several cases on
  • kepd_change Ask kepd's API for any other change

Answering a waiting change

Only for connections set to approve in the app, and only for changes that app asked for.

  • approve_change Approve a waiting change
  • decline_change Decline a waiting change
  • check_change Check what happened to a waiting change

Staying in control

  • An app works inside your business only. It cannot see or reach any other business on kepd.
  • Change what a connected app may do in Settings, then Connected apps, without connecting again: look up only or make changes, and where you approve.
  • Disconnect an app in Settings, then Connected apps, and its next request is refused at once. The Owner can disconnect anyone's app, take someone's access away, or switch connected apps off for the whole business.
  • Changing someone's role, turning off their access or resetting their two-factor sign-in takes effect on their apps straight away.
  • Every request an app makes is logged against the person and the app.

How signing in works

  • The app signs in with OAuth 2.1 (authorisation code with PKCE) through kepd's own sign-in. kepd never sees or stores your app password, and the app never sees your kepd password.
  • You approve the connection on kepd's consent page, after your two-factor code if you use one. kepd recognises the app by where it sends you back to, not by the name it gives itself, and refuses apps it doesn't recognise.
  • The app's access reaches kepd only through kepd's server at https://api.kepd.app/mcp, never the database directly, and every request is checked again: the connection is still live, the business still has connected apps on, and the person is still allowed to connect.

Your data

What kepd returns to a request goes to the AI app you connected and is handled under that app's own terms and privacy policy (Anthropic for Claude, OpenAI for ChatGPT, xAI for Grok, Anysphere for Cursor). kepd keeps a record of each request: which tool, when, by whom and whether it worked. See our Privacy Policy, clause 19.

If something doesn't work

  • "Connected apps are switched off for this business": ask your Owner to switch them on in Settings, then Connected apps.
  • "Your role doesn't allow connecting AI apps": ask your Owner to allow you under Who can connect.
  • "kepd doesn't recognise this app": kepd accepts Claude, ChatGPT, Grok, Cursor and apps on your own computer such as Claude Code. Email us if you use another.
  • The app says it must sign in again: remove kepd from the app and add it again.

Still stuck? Email info@kepd.app.