Account

Search everything

account_search · Reads only · Markdown

One search across the business's files, table rows, help articles, CRM, emails, tickets, invoices, books, stock and tasks.

Free*

*Free up to 1,000,000 reads a month for the whole account, then $0.50 per 10,000 reads.

An example

Find everything we have on the Alder Street Hotel's guest bikes: emails, the quote, the delivery note.

Your agent callsaccount_searchFree*

The example business is Halverson Cycle & Repair, a bike shop with a repair workshop in Portland, Oregon. The reply is the one the tool really gives.

With these arguments
{
  "query": "Alder Street Hotel bikes"
}
What comes back
{
  "query": "Alder Street Hotel bikes",
  "results": [
    {
      "area": "crm",
      "type": "deal",
      "id": 4101,
      "title": "Alder Street Hotel guest bikes",
      "snippet": "Alder Street Hotel guest bikes",
      "updated_at": "2026-10-14T08:00:00+00:00",
      "open_with": {
        "tool": "crm_get_deal",
        "arguments": {
          "deal_id": 4101
        }
      }
    }
  ],
  "more": false
}

Use it when

Something must be found and it is not clear which area holds it.

What it does

One search over what this account holds: what its files say (PDFs, Word, Excel, PowerPoint, text), table rows, help center articles, CRM contacts, companies and deals, emails, tickets, quotes and invoices, book entries, stock items and project tasks. Every word must appear (any case); titles rank first, then the newest. Each result says which tool opens it. Narrow it with areas.

What comes back

Up to 50 matches, titles first and then the newest, each with its area, type, id, title, a snippet and the tool call that opens it, and more: true when there were further matches. Every reply also carries cost_usd and balance_usd.

Inputs

NameTypeWhat it is
queryRequiredstring2 to 200 characters.
areasarray of stringsAt least 1 item. One of: files,tables,helpcenter,crm,email,helpdesk,invoices,books,inventory,projects.
limitinteger1 to 50. Default: 20.

The call

Over MCP, call account_search on https://api.conecto.chat/mcp/account. Over REST:

Terminal
curl -X POST https://api.conecto.chat/v1/tools/account_search \
  -H "Authorization: Bearer $CONECTO_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"Alder Street Hotel bikes"}'

When it refuses

A refused call costs nothing and says what to do next.

CodeWhenWhat to do
invalid_input400The query has no word of two letters or more, or an area is not one of the listed ones.Send at least one word of two letters, and areas from the list in the input schema.

Give this to your agent.

Set up Conecto from https://conecto.chat/SKILL.md