`find_business`

Search businesses by name or keyword to get a handle.

Anonymous, or a Bearer token for viewer tools

Endpoint

endpoint

https://go.sessions.website/api/mcp

When to use it

When you have a business name but not its handle — every other tool takes the handle.
Not needed on the handle-scoped endpoint (/@<handle>/api/mcp), where the business is already pinned.

Parameters

querystringrequired

Business name or keyword.

limitnumberoptional

Max results (default 10).

Returns

Each match with its name, handle and id.

Example

POST this to the endpoint above.

JSON-RPC

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "find_business",
    "arguments": {
      "query": "bodywork",
      "limit": 5
    }
  }
}

content

1 business(es):
- Capital Bodywork (@capital-bodywork)

What the agent is told

The description the model reads when deciding whether to call this. It is the only thing that decides whether the tool fires at the right moment, so it is worth knowing what it says.

find_business

Search Sessions businesses by name or keyword. Returns each match with its handle (the @slug) and id — use the handle with browse_sessions.