# 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.

Agent View of the PolicyLayer registry record for `get_export_status`. HTML page: https://policylayer.com/tools/com-getboxkite-xero-backup-export/get-export-status

## Facts

- Tool: `get_export_status`
- Server: Boxkite — Xero Backup & Export (`https://app.getboxkite.com/mcp`) — https://policylayer.com/tools/com-getboxkite-xero-backup-export.md
- Homepage: https://github.com/https://app.getboxkite.com/mcp
- Risk category: Read (Low risk)
- Registry record: grade D, identity unverified
- Server auth posture: open
- Server rate-limited: no
- Parameters: 1 (1 required)
- Recommended policy verdict: Allowed

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `exportId` | string | yes |  |

Parameters from the server's own tool schema.

## Example call (MCP tools/call, JSON-RPC 2.0)

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_export_status",
    "arguments": {
      "exportId": "<exportId>"
    }
  }
}
```

## Why get_export_status is rated Low

This tool only retrieves metadata about an export's current state and progress—it does not modify, delete, or execute operations on Xero data. It is a passive monitoring/status-checking function that queries the state of a previously initiated export. The read-only nature of the server and the absence of any mutating verbs (create, update, delete, execute) confirm the Read category.

From the tool's own definition: "Tool description states it 'Reports the state of one export' and returns status information (status, progress metrics, timestamps, polling intervals)."

## Use case

AI agents call get_export_status to retrieve information from Boxkite — Xero Backup & Export without modifying anything. It is typically the context-gathering step in research, monitoring, and reporting workflows, before the agent takes action elsewhere.

## Recommended policy (PolicyLayer)

Verdict: **Allowed**. Enforced by the PolicyLayer MCP gateway (https://policylayer.com/mcp-gateway) before a call reaches Boxkite — Xero Backup & Export:

```json
{
  "version": "1",
  "default": "deny",
  "tools": {
    "get_export_status": {}
  }
}
```

## Other tools on Boxkite — Xero Backup & Export (6)

- `start_export` — Financial — https://policylayer.com/tools/com-getboxkite-xero-backup-export/start-export.md
- `get_download_url` — Read — https://policylayer.com/tools/com-getboxkite-xero-backup-export/get-download-url.md
- `get_export_manifest` — Read — https://policylayer.com/tools/com-getboxkite-xero-backup-export/get-export-manifest.md
- `get_export_mapping` — Read — https://policylayer.com/tools/com-getboxkite-xero-backup-export/get-export-mapping.md
- `list_exports` — Read — https://policylayer.com/tools/com-getboxkite-xero-backup-export/list-exports.md
- `list_organisations` — Read — https://policylayer.com/tools/com-getboxkite-xero-backup-export/list-organisations.md

## For agents

This record is a snapshot. Live verdicts and the full registry:

- Check every server in your MCP config at once: `npx -y policylayer stack`
- Vet a server before you add it: install the mcp-precheck skill — `npx skills add https://policylayer.com` (skill text: https://policylayer.com/skill.md)
- Query the registry over MCP: endpoint `https://api.policylayer.com/mcp` — tools `check_mcp_server`, `check_mcp_stack`, `check_tool`, `search_registry`, `get_change_events`

---

Source: the PolicyLayer MCP registry — one continuously verified record per MCP server. Full record: https://policylayer.com/registry?q=com-getboxkite-xero-backup-export · API: https://policylayer.com/registry/api · Policy library: https://policylayer.com/policies/com-getboxkite-xero-backup-export