Docs
MCP serverAvailable tools

Read configuration

Search organization configuration or retrieve one location, expense category, or custom receipt field.

MCP toolget_configuration

Purpose

Search or retrieve organization locations, expense categories, and receipt fields.

Use when
You need organization configuration before creating or updating records.
Do not use when
You need the official SAT product or service-key catalog.
Required permissions
By input.kind: location → receiptOptions:read; expense_category → expenses:read; sales_receipt_field → receiptOptions:read
Side effects
None
Idempotency
Idempotent

Input schema

JSON Schema
{  "type": "object",  "properties": {    "input": {      "oneOf": [        {          "type": "object",          "properties": {            "operation": {              "type": "string",              "const": "search"            },            "kind": {              "$ref": "#/definitions/__schema0"            },            "query": {              "type": "string",              "minLength": 1            },            "cursor": {              "type": "string"            },            "limit": {              "type": "integer",              "minimum": 1,              "maximum": 100            }          },          "required": [            "operation",            "kind"          ],          "additionalProperties": false        },        {          "type": "object",          "properties": {            "operation": {              "type": "string",              "const": "get"            },            "kind": {              "$ref": "#/definitions/__schema0"            },            "entryId": {              "type": "string"            }          },          "required": [            "operation",            "kind",            "entryId"          ],          "additionalProperties": false        }      ]    }  },  "required": [    "input"  ],  "$schema": "http://json-schema.org/draft-07/schema#",  "additionalProperties": false,  "definitions": {    "__schema0": {      "type": "string",      "enum": [        "location",        "sales_receipt_field",        "expense_category"      ],      "description": "location is a business location; expense_category classifies expenses; sales_receipt_field configures custom receipt data"    }  }}

Output schema

JSON Schema
{  "type": "object",  "properties": {    "data": {      "anyOf": [        {          "type": "object",          "properties": {            "locations": {              "type": "array",              "items": {                "$ref": "#/definitions/__schema0"              }            },            "nextCursor": {              "$ref": "#/definitions/__schema2"            },            "hasMore": {              "$ref": "#/definitions/__schema3"            }          },          "required": [            "locations",            "nextCursor",            "hasMore"          ],          "additionalProperties": false        },        {          "type": "object",          "properties": {            "categories": {              "type": "array",              "items": {                "$ref": "#/definitions/__schema4"              }            },            "nextCursor": {              "$ref": "#/definitions/__schema2"            },            "hasMore": {              "$ref": "#/definitions/__schema3"            }          },          "required": [            "categories",            "nextCursor",            "hasMore"          ],          "additionalProperties": false        },        {          "type": "object",          "properties": {            "fields": {              "type": "array",              "items": {                "$ref": "#/definitions/__schema5"              }            },            "nextCursor": {              "$ref": "#/definitions/__schema2"            },            "hasMore": {              "$ref": "#/definitions/__schema3"            }          },          "required": [            "fields",            "nextCursor",            "hasMore"          ],          "additionalProperties": false        },        {          "anyOf": [            {              "$ref": "#/definitions/__schema0"            },            {              "$ref": "#/definitions/__schema4"            },            {              "$ref": "#/definitions/__schema5"            }          ]        }      ]    },    "error": {      "$schema": "http://json-schema.org/draft-07/schema#",      "type": "object",      "properties": {        "code": {          "type": "string",          "enum": [            "validation_error",            "unauthenticated",            "forbidden",            "not_found",            "method_not_allowed",            "conflict",            "idempotency_conflict",            "operation_in_progress",            "recovery_required",            "rate_limited",            "provider_unavailable",            "internal"          ]        },        "message": {          "type": "string"        },        "details": {          "type": "object",          "properties": {            "issues": {              "type": "array",              "items": {                "type": "object",                "properties": {                  "path": {                    "type": "array",                    "items": {                      "anyOf": [                        {                          "type": "string"                        },                        {                          "type": "number"                        }                      ]                    }                  },                  "message": {                    "type": "string"                  },                  "code": {                    "type": "string"                  }                },                "required": [                  "path",                  "message"                ],                "additionalProperties": false              }            },            "retryable": {              "type": "boolean"            },            "retryAfterSeconds": {              "type": "integer",              "exclusiveMinimum": 0,              "maximum": 9007199254740991            }          },          "additionalProperties": false        }      },      "required": [        "code",        "message"      ],      "additionalProperties": false    }  },  "$schema": "http://json-schema.org/draft-07/schema#",  "additionalProperties": false,  "definitions": {    "__schema0": {      "type": "object",      "properties": {        "locationId": {          "type": "string",          "minLength": 1        },        "name": {          "type": "string"        },        "folioPrefix": {          "type": "string"        },        "timeZone": {          "type": "string"        },        "address": {          "type": "object",          "properties": {            "formattedAddress": {              "type": "string"            },            "street": {              "type": "string"            },            "exterior": {              "type": "string"            },            "interior": {              "type": "string"            },            "neighborhood": {              "type": "string"            },            "city": {              "type": "string"            },            "municipality": {              "type": "string"            },            "state": {              "type": "string"            },            "zip": {              "type": "string"            },            "country": {              "type": "string"            },            "placeId": {              "type": "string"            }          },          "additionalProperties": false        },        "pin": {          "type": "object",          "properties": {            "latitude": {              "type": "number",              "minimum": -90,              "maximum": 90            },            "longitude": {              "type": "number",              "minimum": -180,              "maximum": 180            }          },          "required": [            "latitude",            "longitude"          ],          "additionalProperties": false        },        "radiusMeters": {          "type": "number",          "minimum": 0        },        "updatedAt": {          "$ref": "#/definitions/__schema1"        }      },      "required": [        "locationId",        "name",        "updatedAt"      ],      "additionalProperties": false    },    "__schema1": {      "type": "string",      "format": "date-time"    },    "__schema2": {      "anyOf": [        {          "type": "string"        },        {          "type": "null"        }      ]    },    "__schema3": {      "type": "boolean"    },    "__schema4": {      "type": "object",      "properties": {        "categoryId": {          "type": "string",          "minLength": 1        },        "name": {          "type": "string"        },        "updatedAt": {          "$ref": "#/definitions/__schema1"        }      },      "required": [        "categoryId",        "name",        "updatedAt"      ],      "additionalProperties": false    },    "__schema5": {      "type": "object",      "properties": {        "fieldId": {          "type": "string",          "minLength": 1        },        "name": {          "type": "string"        },        "type": {          "type": "string",          "enum": [            "select",            "checkbox"          ]        },        "required": {          "type": "boolean"        },        "order": {          "type": "number"        },        "values": {          "type": "array",          "items": {            "type": "string"          }        }      },      "required": [        "fieldId",        "name",        "type",        "required",        "order",        "values"      ],      "additionalProperties": false    }  },  "oneOf": [    {      "required": [        "data"      ]    },    {      "required": [        "error"      ]    }  ]}

Related workflow

See the canonical workflows in the introduction

Related tools