`search_docs`

Search the schema, embeds and guidance docs by keyword.

No authentication

Endpoint

endpoint

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

When to use it

As the first call when an agent is writing code against the Sessions API and does not know the type or field names yet.
Instead of fetching the whole llms-full.txt when you only need one answer.

Parameters

querystringrequired

Search keywords.

schemastringoptional

Limit schema search (default both).

One of: public, business, both

limitnumberoptional

Max results (default 10, max 50).

Returns

Ranked matches across type, field, operation, embed and guidance docs, each with the schema it belongs to and enough context to decide whether to look it up in full.

Example

POST this to the endpoint above.

JSON-RPC

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "search_docs",
    "arguments": {
      "query": "checkout preview",
      "schema": "public"
    }
  }
}

content

3 match(es) for "checkout preview":
- Query.checkoutPreview (public) — Prices a
  registration without committing to it.
- CheckoutPreviewInput (public, input object)

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.

search_docs

Search the Sessions GraphQL schemas (types, fields, root operations), the embeds catalogue, and the agent guidance for a keyword. Returns ranked, labelled pointers to follow up with get_type / get_operation.