First-party app
Booqable Booqable

Booqable

Manage Booqable rental orders, customers, products and stock.

stable Customer Relationship ManagementCommerce & Payments

About

Booqable ships in the w6w first-party pack. It declares 26 actions, 3 health checks, and the host runs its code in a sandbox that never sees the credential.

App id
io.w6w.booqable
Version
0.1.0
Author
w6w
Licence
MIT
Categories
Customer Relationship Management · Commerce & Payments

Overview

Booqable is rental and equipment management software. This app covers the rental lifecycle from a workflow — creating, updating and fetching orders, transitioning an order through Booqable’s draft/reserved/started/stopped/archived status machine, and searching or archiving customers, products and orders.

Customers can be created, updated, fetched, listed, searched and archived, so a workflow can look up or create the renter behind a booking. Products (the rentable catalog items) can be created, updated, fetched, listed and searched, and archived when discontinued. Stock items — the individually tracked or bulk-counted physical units behind a product — and plannings — the reservations that tie an order’s line items to a date range — can be listed and fetched to check what is actually booked or in stock.

A fit for routing an external booking request into a new Booqable order, moving an order through its rental lifecycle as a workflow progresses (reserve it, start it, stop it), or syncing customer and inventory data between Booqable and the rest of a rental business’s stack.

Build with Booqable

Three routes to the same 26 actions. The Workflow tab is generated from Booqable's own manifest and carries its real ids, so it is copy-pasteable; the Code and CLI examples are the same call for any action on any app, so every app-specific value in them is a blank you fill in.

Archive Customer

customer-archive

Archive a customer. Booqable keeps the record; it stops appearing by default.

Create Customer

customer-create

Create a customer.

Get Customer

customer-get

Fetch a single customer by id.

List Customers

customer-list

List customers, optionally filtered, sorted, sideloaded and paged.

Search Customers

customer-search

Advanced search across customers using a nested and/or filter tree, beyond what a flat filter hash can express.

Update Customer

customer-update

Update fields on an existing customer. Only fields you set are changed.

Create Order

order-create

Create an empty order for a date range. Starts in status `new`.

Get Order

order-get

Fetch a single order by id.

List Orders

order-list

List orders, optionally filtered, sorted, sideloaded and paged.

Search Orders

order-search

Advanced search across orders using a nested and/or filter tree, beyond what a flat filter hash can express.

Transition Order Status

order-status-transition

Move an order between statuses (new, draft, reserved, started, stopped, archived, canceled).

Update Order

order-update

Update fields on an existing order. Only fields you set are changed.

Get Planning

planning-get

Fetch a single planning by id.

List Plannings

planning-list

List plannings (item reservations against a date range), filtered and paged.

Archive Product

product-archive

Archive a product variant. Booqable keeps the record; it stops appearing by default.

Create Product (Variant)

product-create

Create a rentable product variant under a product group. A group with no variations still needs exactly one of these.

Get Product

product-get

Fetch a single product variant by id.

Create Product Group

product-group-create

Create a product group — the shared name/pricing/tracking configuration a rentable Product (or its variations) belongs to.

Get Product Group

product-group-get

Fetch a single product group by id.

List Product Groups

product-group-list

List product groups, optionally filtered, sorted, sideloaded and paged.

Update Product Group

product-group-update

Update fields on an existing product group. Only fields you set are changed.

List Products

product-list

List rentable product variants, optionally filtered, sorted and paged.

Search Products

product-search

Advanced search across product variants using a nested and/or filter tree, beyond what a flat filter hash can express.

Update Product (Variant)

product-update

Update fields on an existing product variant. Only fields you set are changed.

Get Stock Item

stock-item-get

Fetch a single stock item by id.

List Stock Items

stock-item-list

List individually tracked stock items, optionally filtered, sorted and paged.

A workflow step names the app and the action, and the editor fills in the connection when you pick one. This is the Step shape from the workflow spec, carrying Booqable's real ids.

{
  "manifestVersion": "2",
  "name": "booqable-example",
  "steps": [
    {
      "id": "customer-get",
      "uses": {
        "app": "io.w6w.booqable",
        "action": "customer-get",
        "connection": "conn_YOUR_CONNECTION_ID"
      },
      "with": {
        "customerId": "<customerId>"
      }
    }
  ]
}

Here are some of the things you can do

  • Get Customer

    read
    customer-get
  • Create Customer

    perform
    customer-create
  • List Customers

    read
    customer-list
  • Search Customers

    search
    customer-search
  • Update Customer

    perform
    customer-update

+21 more actions available

Every app-specific value here is a blank you have to fill in. An app action is reached through the connection that authenticates it, so the address is a connection id, not the app id — and connections belong to your account, so a public page cannot know yours. Create one for Booqable, then fill in the three blanks: conn_YOUR_CONNECTION_ID, the action key, and the parameters that action declares. The call itself is real — the shape is transcribed from the studio's own snippet builder, which prints the same kind of blanks — but nothing in it is specific to Booqable. The Workflow tab is where this app's real ids are.

Install
npm install @w6w/sdk
yarn add @w6w/sdk
pnpm add @w6w/sdk
deno add npm:@w6w/sdk
Code
import { W6wClient, isActionRun } from "@w6w/sdk";

// Reads W6W_BASE_URL and W6W_TOKEN from the environment when omitted.
const client = new W6wClient();

const envelope = await client.run({
  urn: "conn_YOUR_CONNECTION_ID",
  action: "customer-get",
  payload: {
    customerId: "<value>",
    // include: "<value>",
  },
});

if (isActionRun(envelope)) console.log(envelope.value);
Install the CLI
npm install -g @w6w/cli
CLI
w6w run conn_YOUR_CONNECTION_ID --action customer-get --payload '{"customerId":"<value>"}'

Give an AI agent Booqable — without giving it Booqable's credentials. One MCP endpoint exposes every app, function and workflow the caller is entitled to, as tools it can discover and run. Access is granted per team while we onboard.

One tool call
{
  "name": "w6w_invoke",
  "arguments": {
    "ref": "app:io.w6w.booqable#customer-get",
    "input": {
      "customerId": "<customerId>"
    }
  }
}

Every tool names its target with a single ref. The app: form above doesn't name a connection at all — the host resolves which of the caller's Booqable connections to sign with, and refuses rather than guesses when the answer is ambiguous.

What the agent gets

Credentials it can't read

The token is attached host-side, at the moment of the call. It is never a tool argument, never in the model's context, and never in a transcript — so a prompt injection has nothing to exfiltrate.

A tool surface scoped to the caller

Tools are derived per end user from what that person has actually connected and is entitled to — not one shared bot identity carrying the union of everyone's access.

A durable workflow in one call

Multi-step work runs on the workflow engine and returns a run handle the agent can poll — retries, branching and state survive the conversation that started them.

Health-aware discovery

Booqable's declared health checks are on the surface too, so an agent can tell "the vendor is down" from "your credential expired" before it burns a retry on either.

The MCP surface is part of the hosted platform. Booqable itself is MIT, and the runtime that executes it is source-available (FSL).

Request MCP access

Health checks

Booqable declares its own checks, so its health is a property of the app rather than something the host guesses at.

service

Booqable platform status

Open incidents on status.booqable.com's Atom history feed. Unauthenticated and unsigned; fetched and parsed by the host.

dependency

Company slug reachable

Unauthenticated request to this connection's Booqable company slug. A 401 passes — it proves the company exists and is serving; credential validity is the `auth:*` check's job.

quota

Monthly API-call headroom

Monthly call allowance from `companies/current`'s subscription.restrictions.api_monthly_calls and subscription.api_usage_count. Also reports the account's shorter-window rate limit (calls per period), which carries no usage counter to compute headroom from.