Acumatica MCP server

Read from the package source without running it. The installed server may list more.

• check_inventory

  Check stock availability for an item across warehouses.

• connection_status

  Check whether the Acumatica connection is configured and working.

• create_recordwrite action

  Create a new record via the Contract-Based API (insert only).

• delete_attachmentwrite action

  Delete a specific file attachment from an Acumatica record.

• delete_recordwrite action

  Delete a record by its key field values.

• describe_endpoint

  Get the full schema for a Contract-Based API endpoint — field names, types, and expandable detail entities.

• describe_entity

  Compact schema for a specific entity — field names, types, and detail entities.

• get_acumatica_version

  Retrieve the Acumatica ERP version and the list of all available endpoints.

• get_attachment_metadata

  Get metadata for a specific attachment without downloading it.

• get_customer_balance

  Get the AR balance, credit status, and open invoices for a customer.

• get_record_by_keys

  Fetch a single record by its key field values using path segments.

• get_record_history

  Get the creation and last-modification timestamps for a record.

• get_records

  Query records using OData filters.

• gi_suite_status

  Check whether the paid GI Suite customisation package is installed.

• invoke_action

  Trigger an Acumatica action on a specific record.

• list_attachments

  List all file attachments on an Acumatica record.

• list_available_entities

  Flat list of all queryable entities — much cheaper than list_endpoints.

• list_companies

  List the companies (tenants) available in this Acumatica instance.

• list_endpoints

  List available Contract-Based API entity endpoints.

• list_generic_inquiries

  List Generic Inquiries available for querying.

• patch_recordwrite action

  Partially update a record — only the fields specified in data are changed.

• query_generic_inquiry

  Query an Acumatica Generic Inquiry by its Site Map Title via OData.

• refresh_schema_cache

  Clear the schema and tenant discovery caches, forcing a fresh fetch.

• run_reportwrite action

  Generate an Acumatica report and return the output as base64-encoded content.

• search_records

  Search records by keyword — fetches from API then filters server-side using case-insensitive substring matching.

• switch_company

  Switch the active company for all subsequent requests.

• track_shipment

  Look up shipment details and tracking information.

• update_recordwrite action

  Update an existing record via the Contract-Based API (update only).

• Code scan4 source files scanned25/25
• –Live reliabilityno gateway calls yet and no remote to proben/a
• –Tool poisoningtools not inspected (local package is not executed); not countedn/a
• Auth qualitystatic API keys via environment variables6/15
• Maintenancerepository not readable: repo not found3/15
• Maintainer identityno repository or website to verify2/10

Acumatica: common questions

Is Acumatica MCP server safe?

With care: it is graded C, so read the findings first (55/100). Read the Acumatica safety report

How do I install Acumatica?

It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.

Does Acumatica need an API key?

Yes. The registry entry asks for ACUMATICA_PASS, ACUMATICA_CLIENT_SECRET.

Is Acumatica maintained?

The latest release is v0.9.0.