me.start

Start here. Shops this connection can use, the grant in plain words, counts, and the next tasks for the state of each shop.

WhoAgents can call this
RESTGET /v1/me/start
MCP toolme_start
Writesno
AreaShop

When to use it

Start here. Shops this connection can use, the grant in plain words, counts, and the next tasks for the state of each shop.

What to tell the owner

Tell them what you found in plain words. Don't read back raw fields.

Input

FieldTypeRequired
(none)

Example

GET https://doingwork.work/v1/me/start?

Output

FieldTypeAlways there
grantstringyes
bindingstringyes
bound_shop_id['string', 'null', ' ', '(', 'u', 'u', 'i', 'd', ')']yes
shopsarrayyes
shops[].shop_idstring (uuid)yes
shops[].namestringyes
shops[].rolestringyes
shops[].customersintegeryes
shops[].open_jobsintegeryes
shops[].draft_quotesintegeryes
shops[].open_invoicesintegeryes
canarrayyes
cannotarrayyes
tasksarrayyes
tasks[].shop_id['string', 'null', ' ', '(', 'u', 'u', 'i', 'd', ')']yes
tasks[].saystringyes
tasks[].toolstringyes
tasks[].argumentstringyes
next_actionsarrayyes
next_actions[].saystringyes
next_actions[].op['string', 'null']yes
next_actions[].whenstring (one of now, later, check, tell_human)yes
next_actions[].due_at['string', 'null', ' ', '(', 'd', 'a', 't', 'e', '-', 't', 'i', 'm', 'e', ')']no
next_actions[].args_hintstringno
feesobjectyes
fees.toolstringyes
fees.saystringyes
approvalsobjectyes
approvals.toolstringyes
approvals.saystringyes
nextstringyes
{
  "grant": "...",
  "binding": "...",
  "bound_shop_id": "00000000-0000-4000-8000-000000000000",
  "shops": [
    {
      "shop_id": "00000000-0000-4000-8000-000000000000",
      "name": "Ruiz Plumbing",
      "role": "...",
      "customers": 1,
      "open_jobs": 1,
      "draft_quotes": 1,
      "open_invoices": 1
    }
  ],
  "can": [
    "..."
  ],
  "cannot": [
    "..."
  ],
  "tasks": [
    {
      "shop_id": "00000000-0000-4000-8000-000000000000",
      "say": "...",
      "tool": "...",
      "argument": "..."
    }
  ],
  "next_actions": [
    {
      "say": "...",
      "op": "...",
      "when": "now"
    }
  ],
  "fees": {
    "tool": "...",
    "say": "..."
  },
  "approvals": {
    "tool": "...",
    "say": "..."
  },
  "next": "..."
}

Errors

CodeStatusWhat to do
invalid_input, invalid_token, rate_limitedCan happen on any call. See errors.