{
  "provider": "quickfile",
  "description": "QuickFile beta REST MCP with explicit multi-account routing",
  "documentation": "https://github.com/marcusquinn/quickfile-mcp",
  "api_documentation": "https://api-beta.quickfile.co.uk/api-docs/",
  "prerequisites": {
    "node_version": "Use the exact .nvmrc version; v4.0.0 declares >=24.0.0 <25.0.0",
    "package_manager": "Use the packageManager version declared by quickfile-mcp",
    "install_commands": [
      "mkdir -p ~/Git/mcp && git clone https://github.com/marcusquinn/quickfile-mcp.git ~/Git/mcp/quickfile-mcp",
      "cd ~/Git/mcp/quickfile-mcp && nvm install && nvm use && corepack enable && npm ci && npm run build"
    ],
    "credentials_backend": "aidevops secret",
    "credentials_pattern": "QUICKFILE_<ACCOUNT>_API_KEY",
    "credentials_setup": "aidevops secret set QUICKFILE_BUSINESS_API_KEY",
    "launcher": "~/.aidevops/agents/scripts/quickfile-mcp-launcher.sh",
    "legacy_install_path": "~/Git/quickfile-mcp remains discoverable; new installs use ~/Git/mcp/quickfile-mcp"
  },
  "mcp_tool_coverage": "112 operations in v4.0.0: 37 curated tools listed below plus 75 generated quickfile_rest_* operations from the published REST v2 schema",
  "curated_mcp_tools": [
    "quickfile_system_get_account",
    "quickfile_system_search_events",
    "quickfile_client_search",
    "quickfile_client_get",
    "quickfile_client_create",
    "quickfile_client_update",
    "quickfile_client_delete",
    "quickfile_client_insert_contacts",
    "quickfile_client_login_url",
    "quickfile_invoice_search",
    "quickfile_invoice_get",
    "quickfile_invoice_create",
    "quickfile_invoice_delete",
    "quickfile_invoice_send",
    "quickfile_invoice_get_pdf",
    "quickfile_purchase_search",
    "quickfile_purchase_get",
    "quickfile_purchase_create",
    "quickfile_purchase_delete",
    "quickfile_supplier_search",
    "quickfile_supplier_get",
    "quickfile_supplier_create",
    "quickfile_supplier_update",
    "quickfile_supplier_delete",
    "quickfile_bank_get_accounts",
    "quickfile_bank_get_balances",
    "quickfile_bank_search",
    "quickfile_bank_create_account",
    "quickfile_bank_create_transaction",
    "quickfile_report_profit_loss",
    "quickfile_report_balance_sheet",
    "quickfile_report_vat_obligations",
    "quickfile_report_ageing",
    "quickfile_report_chart_of_accounts",
    "quickfile_report_subscriptions",
    "quickfile_document_upload_receipt",
    "quickfile_document_upload_sales_attachment"
  ],
  "verification_prompt": "Show account details for the business QuickFile account",
  "configuration": {
    "opencode": {
      "type": "local",
      "command": ["/Users/YOU/.aidevops/agents/scripts/quickfile-mcp-launcher.sh"],
      "enabled": false,
      "tool_permissions": {
        "global": false,
        "quickfile_agent": true
      }
    },
    "generic_stdio": {
      "command": "/Users/YOU/.aidevops/agents/scripts/quickfile-mcp-launcher.sh",
      "args": []
    }
  },
  "rate_limits": {
    "default": "5000 API calls per rolling 24 hours per personal token",
    "response": "Treat HTTP 429 as a wait state; do not retry aggressively"
  },
  "troubleshooting": {
    "credentials_not_found": "Store at least one QUICKFILE_<ACCOUNT>_API_KEY secret and restart the MCP runtime",
    "auth_failed": "Verify the selected alias, personal token validity, and granted endpoint groups",
    "unknown_account": "Use an alias derived from a configured token secret name",
    "build_failed": "Select the exact .nvmrc Node.js version and declared package manager, then run npm ci and npm run build in ~/Git/mcp/quickfile-mcp",
    "mcp_not_responding": "Run QUICKFILE_MCP_LAUNCHER_DRY_RUN=1 quickfile-mcp-launcher.sh, rebuild, and restart the runtime"
  },
  "notes": {
    "api_version": "QuickFile beta REST API",
    "auth_method": "Personal bearer token",
    "account_selection": "Every MCP tool requires account",
    "mutation_confirmation": "MCP mutations require confirmed true; CLI mutations require --confirm",
    "readback": "Verify consequential changes through a provider read after mutation",
    "vat_support": "Mutations require explicit per-line VAT unless account VAT posture is configured",
    "uk_only": "QuickFile is UK-focused accounting software"
  }
}
