com.synder/gl-importer-mcp

NPM · @CLOUDBUSINESS/GL-IMPORTER-MCP · SCANNED AUG 3

Import CSV/XLSX accounting data into QuickBooks Online or Xero via the Synder Importer API.

Available components

+35 this week 81 81 Trust /100

Trust breakdown (6 categories)

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score →

Supply Chain Security87

No malware found by supply-chain analysis.Pass
Only part of the dependency tree could be resolved (95 of 99), so this covers what we could see, not the whole tree.Partial
No install/post-install scripts declared.Pass
Only part of the dependency tree could be resolved (95 of 99), so this covers what we could see, not the whole tree. View diagnostics → Partial

Provenance & Transparency97

Source repository is publicly reachable at the declared URL. View diagnostics → Pass
Cryptographically verified build provenance (signed, bound to SynderAccounting/gl-importer-plugin). View diagnostics → Pass
Clear OSI-approved license (MIT).Pass
Actively maintained (last published 43 days ago).Pass
Disclosure check failed: no security disclosure policy was found in the source repository. See how to fix → Fail

Schema Quality & AI Usability81

AI-judged instruction clarity (excellent).Pass
Tool/resource definitions use about 1855 tokens (~97/item across 19 items; 19 tools + 0 resources), lean.Pass
Usage-examples check failed: none of the tools include examples. See how to fix → Fail

Stability & Change Management27

Stability observed for 8 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial

Tool Coverage100

100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
100% of tool parameters carry a description.Pass

Capabilities100

Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass

Install

Add this component to your MCP client. Where a client-specific snippet is available, pick your client below and copy it straight into your config; otherwise use the connection detail shown.

npm · @cloudbusiness/gl-importer-mcp

Claude Codex opencode OpenClaw Hermes Other

# add to Claude Code

claude mcp add com-synder-gl-importer-mcp -- npx -y @cloudbusiness/gl-importer-mcp

# add to Codex CLI

codex mcp add com-synder-gl-importer-mcp -- npx -y @cloudbusiness/gl-importer-mcp

// opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "com-synder-gl-importer-mcp": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "@cloudbusiness/gl-importer-mcp"
      ],
      "enabled": true
    }
  }
}

# add to OpenClaw

openclaw mcp add com-synder-gl-importer-mcp --command npx --arg -y --arg @cloudbusiness/gl-importer-mcp

# ~/.hermes/config.yaml

mcp_servers:
  com-synder-gl-importer-mcp:
    command: "npx"
    args: ["-y", "@cloudbusiness/gl-importer-mcp"]

// mcp.json

{
  "mcpServers": {
    "com-synder-gl-importer-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@cloudbusiness/gl-importer-mcp"
      ]
    }
  }
}

Changelog

Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.

3 Aug 26 +1

No change was recorded against any check on this day. Stability & Change Management went from 23 to 27. That category is still filling its 30-day observation window: 7 days of observed history at the previous scan, 8 at this one. The score rises as the window fills, whether or not the server changes.
2 Aug 26 +60
- Install scripts: unverified → pass ▲ security
- Provenance: unverified → pass ▲ security
- Known CVEs: unverified → partial ▲ security
- The attested source repository moved: SynderAccounting/gl-importer-plugin security
- MCP protocol: unverified → pass ▲ functional
- Stability: unverified → 0.23 ▲ functional
- Maintenance: unverified → pass ▲ functional
- Schema quality: unverified → excellent ▲ functional
- License: unverified → pass ▲ functional
- Dependency health: unverified → partial ▲ functional
- Tool coverage: unverified → 100 ▲ functional
- Licence: MIT functional
1 Aug 26 −30
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
31 Jul 26 +25
- Malware scan: pass → unverified ▼ security
- Install scripts: unverified → pass ▲ security
- Provenance: unverified → pass ▲ security
- The attested source repository moved: SynderAccounting/gl-importer-plugin security
- Security disclosure: unverified → fail ▼ functional
- Dependency health: partial → unverified ▼ functional
- Tool coverage: unverified → 100 ▲ functional
- License: unverified → pass ▲ functional
- Maintenance: unverified → pass ▲ functional
- Licence: MIT functional
29 Jul 26 −21
- Tool coverage: 100 → unverified ▼ functional
- Security disclosure: fail → unverified ▼ functional
- Dependency health: unverified → partial ▲ functional
- First check of Schema quality: unverified functional
27 Jul 26 46

First indexed and scored.

Show 3 earlier entries Hide earlier entries

Diagnostics

Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.

Captured 3 Aug 2026 · Analysed npm/@cloudbusiness/[email protected]

Provenance verified

Ecosystem: npm · Outcome: verified

Reason: verified

Source repo:: SynderAccounting/gl-importer-plugin
Certificate issuer:: https://token.actions.githubusercontent.com
Certificate SAN:: https://github.com/SynderAccounting/gl-importer-plugin/.github/workflows/publish.yml@refs/tags/v0.1.1
Rekor log index:: 1875970348
Predicate type:: https://slsa.dev/provenance/v1
Subject digest:: sha512:1e90d0437e6f4c8d4a8cfbb1ac7bb6afdfefbf266151563e2982433837957ecb586b5ebfdaa15a2141088ac48e40986e09ee3ad103afb858a89be51db
Discovery method:: attestation_endpoint

Dependencies 95 packages

95 packages in the resolved dependency tree · 95 deprecated · 29 stale.

The dependency tree was only partially resolved, so these counts may be incomplete.

MCP tools — 19 exposed · ~1,855 tokens

The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability.

Tool Tokens

account_get ~43

Returns the current Synder Importer account: email, name, status, subscription, and connected-company count. Call this first to verify the IMPORTER_API_TOKEN is valid.

Input Output Examples

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

companies_list ~47

Lists all accounting companies connected to the Importer account (QuickBooks Online via 'intuit', Xero via 'xero'). Use the returned 'id' as companyId for downstream tools.

Input Output Examples

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

entities_list ~59

Lists importable entity types for a company (Invoice, Bill, JournalEntry, Customer, Vendor, etc.). Use the returned 'name' as entityName for fields_get and import tools.

Input Output Examples

Name	Type	Req	Description
companyId	string	yes	Company id from companies_list.

No output schema declared.

No examples provided.

fields_get ~82

Returns the field schema for an entity in a company: every field with its type, required flag, alternativeTitles, and predefinedValues. Use to build or verify a mapping before running an import.

Input Output Examples

Name	Type	Req	Description
companyId	string	yes	Company id from companies_list.
entityName	string	yes	Entity name from entities_list (e.g., 'Invoice', 'Bill').

No output schema declared.

No examples provided.

import_auto ~149

Uploads a file and asks the server to auto-map columns to the target entity. Set dryRun=true to get the proposed mapping back without creating an import — useful for showing the user what will happen and asking 'does this look right?' before committing. Set dryRun=false (default) to auto-map and import in one call.

Input Output Examples

Name	Type	Req	Description
companyId	string	yes	Company id from companies_list.
dryRun	boolean	—	If true, returns proposed mapping without starting an import. Default false.
entityName	string	yes	Entity to import as — must match entities_list output.
filePath	string	yes	Absolute path to a .csv, .xlsx, or .xls file.

No output schema declared.

No examples provided.

import_cancel ~67

Cancels a SCHEDULED or IN_PROGRESS import. Already-imported rows are NOT rolled back — use import_revert for that. Returns the updated import status.

Input Output Examples

Name	Type	Req	Description
companyId	string	yes	Company id from companies_list.
importId	string	yes	Import id from imports_list.

No output schema declared.

No examples provided.

import_csv ~218

Happy-path CSV/XLSX importer. Two-step: first call (without confirmed) auto-resolves the company, uploads the file, and returns the server's proposed mapping plus any missingRequired fields — show this to the user. Re-call with confirmed=true (and the same filePath) to run the real import and poll until it terminates. Returns { stage: 'DRY_RUN' | 'DONE', importId?, status, summary?, proposedMapping?, missingRequired? }.

Input Output Examples

Name	Type	Req	Description
companyId	string	—	Optional. If omitted and exactly one ACTIVE company exists, it's picked automatically.
confirmed	boolean	—	Set true on the second call to commit the import. Default false (dry-run only).
entityName	string	yes	Entity to import as — match entities_list (e.g. 'Journal Entry').
filePath	string	yes	Absolute path to a .csv, .xlsx, or .xls file.
timeoutSeconds	integer	—	Forwarded to import_wait on the confirmed call. Default 600.

No output schema declared.

No examples provided.

import_execute ~162

Uploads a CSV/XLSX file and starts an import using an existing mapping. The MCP server reads the file from disk — pass an absolute path. Returns the created import object including importId. Status starts as SCHEDULED — poll import_status or use import_wait. Limits: .csv/.xlsx/.xls only, 50MB max.

Input Output Examples

Name	Type	Req	Description
companyId	string	yes	Company id from companies_list.
entityName	string	yes	Entity to import as — must match entities_list (e.g. 'Journal Entry').
filePath	string	yes	Absolute path to a .csv, .xlsx, or .xls file on the machine running the MCP server.
mappingId	string	yes	Mapping id from mappings_list to apply to the file.

No output schema declared.

No examples provided.

import_results ~125

Returns per-row results for a finished import. Filter by 'type' (INFO / WARNING / ERROR) to surface only failures. Paginated — defaults to 20 rows per page, max 100.

Input Output Examples

Name	Type	Req	Description
companyId	string	yes	Company id from companies_list.
importId	string	yes	Import id from imports_list.
page	integer	—	Page number (1-indexed). Default 1.
perPage	integer	—	Rows per page. Default 20, max 100.
type	string	—	Optional: filter rows by result type.

No output schema declared.

No examples provided.

import_revert ~90

Reverts a FINISHED or FINISHED_WITH_WARNINGS import — deletes the QuickBooks/Xero entries the import created, using their live SyncTokens. Status transitions FINISHED → REVERTING → REVERTED. Confirm with the user before calling — irreversible from their perspective.

Input Output Examples

Name	Type	Req	Description
companyId	string	yes	Company id from companies_list.
importId	string	yes	Import id from imports_list.

No output schema declared.

No examples provided.

import_status ~90

Returns a single import's current status and summary (total / succeeded / failed / warnings). Status lifecycle: SCHEDULED → IN_PROGRESS → FINISHED | FINISHED_WITH_WARNINGS | FAILED | CANCELED. FINISHED can transition to REVERTING → REVERTED.

Input Output Examples

Name	Type	Req	Description
companyId	string	yes	Company id from companies_list.
importId	string	yes	Import id from imports_list.

No output schema declared.

No examples provided.

import_wait ~164

Polls import_status until the import reaches a terminal state (FINISHED, FINISHED_WITH_WARNINGS, FAILED, CANCELED, REVERTED). Exponential backoff (2s → 1.5× → cap 30s). Default timeout 600s — if exceeded, returns { status: 'POLLING', importId, lastSeen } so the LLM can re-call. Includes a per-type result count summary on terminal states (INFO / WARNING / ERROR; null if the server didn't return totals).

Input Output Examples

Name	Type	Req	Description
companyId	string	yes	Company id from companies_list.
importId	string	yes	Import id from imports_list or import_execute.
timeoutSeconds	integer	—	Max seconds to wait before returning POLLING. Default 600.

No output schema declared.

No examples provided.

imports_list ~47

Lists recent imports for a company with status and timestamps. Use to find an importId for status / results / revert / cancel.

Input Output Examples

Name	Type	Req	Description
companyId	string	yes	Company id from companies_list.

No output schema declared.

No examples provided.

mapping_create ~122

Creates a new field mapping for an entity (e.g. 'Journal Entry', 'Bill', 'Invoice'). Look up valid target fields with fields_get first. Returns the created mapping including its id.

Input Output Examples

Name	Type	Req	Description
companyId	string	yes	Company id from companies_list.
entityName	string	yes	Entity this mapping targets — must match entities_list output (e.g. 'Journal Entry').
fields	array	yes	Field mappings. Each entry maps a CSV column or a constant to an Importer target field.
title	string	yes	Human-readable mapping name.

No output schema declared.

No examples provided.

mapping_delete ~61

Deletes a saved mapping. Irreversible. Imports that referenced this mapping keep their historical record but new imports can no longer pick it.

Input Output Examples

Name	Type	Req	Description
companyId	string	yes	Company id from companies_list.
mappingId	string	yes	Mapping id from mappings_list.

No output schema declared.

No examples provided.

mapping_update ~112

Replaces an existing mapping in full. Fetch the current mapping with mappings_list first and send the whole desired shape — this is a PUT, not a patch. Returns the updated mapping.

Input Output Examples

Name	Type	Req	Description
companyId	string	yes	Company id from companies_list.
entityName	string	yes	Entity this mapping targets — must match entities_list output.
fields	array	yes	Field mappings (full replacement).
mappingId	string	yes	Mapping id from mappings_list.
title	string	yes	Human-readable mapping name.

No output schema declared.

No examples provided.

mappings_list ~41

Lists field mappings saved for a company. Each mapping is reusable across imports of the same entity type.

Input Output Examples

Name	Type	Req	Description
companyId	string	yes	Company id from companies_list.

No output schema declared.

No examples provided.

settings_get ~56

Returns per-company import settings (dateFormat, document-number behavior, product/account auto-creation, duplicate-skip). Check dateFormat before importing — CSV date columns must match.

Input Output Examples

Name	Type	Req	Description
companyId	string	yes	Company id from companies_list.

No output schema declared.

No examples provided.

settings_update ~120

Updates per-company import settings. Pass only the fields you want to change inside 'settings' (e.g. { dateFormat: 'dd/MM/yyyy' }). Fetch current values with settings_get first so you don't clobber unrelated fields. Returns the updated settings.

Input Output Examples

Name	Type	Req	Description
companyId	string	yes	Company id from companies_list.
settings	object	yes	Settings patch. Common fields: dateFormat ('MM/dd/yyyy' \| 'dd/MM/yyyy' \| 'yyyy-MM-dd'), incrementDocNumber, createMissingProducts, createMissingAccounts, skipDuplicates.

No output schema declared.

No examples provided.

On this page

Handy links

Scoring key

80+ high trust
60–79 medium
below 60 low

How we score

Score history · last 30 days

27 Jul 3 Aug