Search relations

Customers and suppliers (relations) by name, with code, city and status.

MCP tool exact_online_read → search_relations

read

Searches the relations of one division by name or code and returns up to one page of matches. Use the account_id of a match as the customer of create_sales_invoice. An empty list means no relation matches, and create_relation can add it.

Parameters

Parameters: search_relations
NameTypeDescription
division integer integer Division (company) code from list_divisions. Default: the account's current division.
query string required string Part of the name or the code.
limit integer integer Records per page. Default: 50.
cursor string string Next page cursor from the previous call.

tools/call

JSON-RPC

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "exact_online_read",
    "arguments": {
      "operation": "search_relations",
      "arguments": {
        "query": "query"
      }
    }
  }
}

Example response

JSON

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "relations": [
      {
        "account_id": "8a3f1c20-2b6e-4d44-9e0b-7f4c1d2a9001",
        "code": "1042",
        "name": "Northwind Studio",
        "city": "Utrecht",
        "status": "customer"
      }
    ],
    "next_cursor": null
  },
  "isError": false
}

Sign in once. Your agent does the rest.

Sign up and add the apps you need. Free 7-day trial with 2,000 credits, no card needed.