MCP-Server

Boxkite — Xero Backup & Export

com.getboxkite/xero-backup-export
Business & Betrieb Finanzen & Investieren Öffentlich und erreichbar MCP 2025-11-25

Was dieses MCP kann

Starts and manages read-only accounting exports from connected Xero, Sage, Reckon, or QuickBooks organisations.

get_download_url
Get export download URL
Returns a short-lived signed URL for the export ZIP, valid within the export's 7-day retention window, along with byteSize (the archive's size in bytes, null if unavailable) and fileCount. These archives range from a few MB to several GB. The archive contains the exported files plus manifest.json (every file with its sha256) and Info/ (the file-to-Xero-object mapping).
Nur Lesen Externer Zugriff
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['exportId'], 'properties': {'exportId': {'type': 'string'}}}
get_export_manifest
Get export manifest
See what an IN-PROGRESS export contains so far (entities included, per-entity record/file counts, and per-file checksums), growing as discovery and downloading proceed. The per-file list is paged: check filesPage.hasMore and pass fileOffset to walk it. Once the export finishes, this returns status 'complete' with a pointer instead of a list, because the full manifest travels inside the ZIP as manifest.json: get a download URL, then read manifest.json from the archive.
Nur Lesen Externer Zugriff
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['exportId'], 'properties': {'exportId': {'type': 'string'}, 'fileLimit': {'type': 'integer', 'maximum': 5000, 'minimum': 1, 'description': 'Files per page (default 500, max 5000)'}, 'fileOffset': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0, 'description': 'Index of the first file to return (default 0)'}}}
get_export_mapping
Get export file→object mapping
For an IN-PROGRESS export, get the mapping of each file discovered so far to the accounting object it represents or is attached to (e.g. which invoice a receipt PDF belongs to). Paged (default 200 files, max 500): check filesPage.hasMore and pass fileOffset for the next page; the `objects` map covers only the files on the current page. Once the export finishes, this returns status 'complete' with a pointer instead: the full mapping ships under Info/ inside the ZIP, so download the archive and read Info/files.json from it.
Nur Lesen Externer Zugriff
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['exportId'], 'properties': {'exportId': {'type': 'string'}, 'fileLimit': {'type': 'integer', 'maximum': 500, 'minimum': 1, 'description': 'Files per page (default 200, max 500)'}, 'fileOffset': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0, 'description': 'Index of the first file to return (default 0)'}}}
get_export_status
Get export status
Reports the state of one export: status (queued | running | ready | failed) and whether its download is available yet. Also returns progress {discovered, transferred, percent}; parkedUntil; and pollAfterSeconds, the interval after which this status is expected to have changed. A large export runs for hours, so pollAfterSeconds can be a long interval. parkedUntil is a timestamp, present whenever work on the organisation is paused and expected to resume. How long varies by cause and is not worth guessing at: hitting Xero's per-minute limit pauses for under a minute, approaching its daily quota pauses for about an hour, and exhausting the daily quota or Boxkite's own egress budget pauses until the next UTC day. Wait until the timestamp (or pollAfterSeconds, which already accounts for it) rather than describing a cause to the user.
Nur Lesen Externer Zugriff
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['exportId'], 'properties': {'exportId': {'type': 'string'}}}
list_exports
List exports
List one-off exports (newest first), optionally for one organisation. Use this to find an export after payment and to poll its status until it is 'ready'. Side-effect free: it never starts a new export or charges anything. Each entry carries progress, parkedUntil and pollAfterSeconds.
Nur Lesen Externer Zugriff
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'organisationId': {'type': 'string'}}}
list_organisations
List accounting organisations
List the accounting organisations (Xero, Sage, Reckon, or QuickBooks) connected to the authenticated Boxkite account.
Nur Lesen Externer Zugriff
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
start_export
Start a one-off accounting data export
Starts a read-only export of one accounting organisation's data (Xero, Sage, Reckon, or QuickBooks). Costs $39 per organisation: when payment is outstanding the response is status 'awaiting_payment' with a Stripe checkoutUrl for the user to complete in a browser, and the export begins once that payment settles. This is not a status endpoint: it reports only the state at creation, and repeat calls return the existing export for that organisation rather than creating or charging for a second one. Export progress is reported by get_export_status, and newly created exports appear in list_exports. A typical export runs for hours, and pauses whenever it meets a provider rate limit or Boxkite's egress budget — anything from under a minute to the next UTC day. get_export_status reports when it resumes.
Destruktiv Externer Zugriff Idempotent
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['organisationId'], 'properties': {'organisationId': {'type': 'string', 'description': 'Organisation id from list_organisations'}}}
Hinzugefügt
get_download_url
17. September 2026 12:35
Hinzugefügt
get_export_mapping
17. September 2026 12:35
Hinzugefügt
get_export_manifest
17. September 2026 12:35
Hinzugefügt
get_export_status
17. September 2026 12:35
Hinzugefügt
list_exports
17. September 2026 12:35
Hinzugefügt
start_export
17. September 2026 12:35
Hinzugefügt
list_organisations
17. September 2026 12:35