macola-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| MACOLA_AUTH | No | Authentication mode. 'windows' (default): sign in as the current Windows user. 'basic': fixed account from MACOLA_USERNAME / MACOLA_PASSWORD (avoid if you can). | windows |
| MACOLA_CURL | No | Optional path to a curl.exe with SSPI. Default: %windir%\System32\curl.exe, then Git for Windows' curl. | |
| MACOLA_SERVER | No | Your Macola server's name, e.g. ERPSERVER (becomes http://ERPSERVER/Macola/api). Use the server's name, not its IP address; Kerberos needs the name. | |
| MACOLA_BASE_URL | No | Instead of MACOLA_SERVER: the full API address for non-standard setups (HTTPS, other path or port), e.g. https://erp.example.local/Macola/api. | |
| MACOLA_PASSWORD | No | Password for MACOLA_AUTH=basic. Required when using basic authentication. | |
| MACOLA_READONLY | No | Set to 'true' to offer only read tools (61 of 88). Unset or 'false' enables all tools, including create/update/delete. | false |
| MACOLA_USERNAME | No | Username for MACOLA_AUTH=basic. Required when using basic authentication. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| addresses_findC | Get Addresses. Supports filtering by any address property via query parameters. |
| addresses_getB | Get the Address for a particular entry by specifying its ID. |
| addresses_createD | Creates a new Address. |
| addresses_updateC | Updates the specified Address with the data provided. PUT and PATCH are interchangeable. |
| addresses_deleteC | Deletes the specific Address. |
| addresses_address_bookC | Get Addresses and Contacts for a given account. |
| contacts_findC | Get Contacts. Supports filtering by any contact property. |
| contacts_getC | Get the Contact for a particular entry by specifying its ID. |
| contacts_createD | Creates a new Contact. |
| contacts_updateA | Updates a Contact. Identify it by ID (the number, e.g. 7029) or ContactID (the GUID); the tool looks up the contact, its current RowVersion and stored email itself, so pass only the fields you want to change (e.g. { ID: 7029, Email: "new@example.com" }). Returns the changed fields before and after. |
| contacts_deleteC | Deletes the specific Contact. |
| customer_orders_findC | Find Customer Orders. Filter by CustomerNumber, OrderType, Status, dates, etc. |
| customer_orders_getB | Get one Customer Order for a particular entry by specifying its ID. |
| customer_orders_createD | Creates a new Customer Order. |
| customer_orders_updateC | Updates the specified Customer Order with the data provided. If CustomerOrderComments is provided, all previous comments will be replaced. |
| customer_orders_deleteC | Deletes the specific Customer Order. |
| customer_orders_remove_credit_holdC | Attempts to remove a Customer Order from credit hold status, given the OrderType and OrderNumber. |
| customer_orders_create_from_masterC | Create a Regular Order (Type O) from a Master Order (Type M). |
| customer_order_lines_findC | Find Customer Order Lines. Filter by OrderNumber, ItemNumber, CustomerNumber, etc. |
| customer_order_lines_getB | Get the Customer Order Line for a particular entry by specifying its ID. |
| customer_order_lines_createD | Creates a new Customer Order Line. |
| customer_order_lines_updateC | Updates the specified Customer Order Line with the data provided. |
| customer_order_lines_deleteC | Deletes the specific Customer Order Line. |
| customer_items_findC | Find Customer Items (customer-specific item numbers/descriptions). |
| customer_items_getC | Get the Customer Item by ID. |
| comment_codes_findD | Find some or all Comment Codes (Shipping Instructions). |
| comment_codes_getB | Get the Comment Code for a particular entry by specifying its ID. |
| comment_codes_createC | Creates a new Comment Code (Shipping Instruction). |
| comment_codes_updateC | Updates the specified Comment Code (Shipping Instruction) with the data provided. |
| comment_codes_deleteC | Deletes the specific Comment Code (Shipping Instruction). |
| inventory_items_findC | Find Inventory Items (master item records). |
| inventory_items_getB | Get the Inventory Item for a particular entry by specifying its item number ID. |
| inventory_transaction_requestC | Request a new Inventory Transaction. Only Issue and Receipt types are currently supported. |
| inventory_locations_findC | Find Inventory Location entries (item quantities at specific locations). |
| inventory_locations_getB | Get one Inventory Location entry by specifying its ID. |
| inventory_bins_findC | Find Inventory Bin entries. |
| inventory_bins_getB | Get the Inventory Bin information for a particular entry by specifying its ID. |
| inventory_kits_findD | Find Inventory Kit data. |
| inventory_kits_getB | Get the Inventory Kit information for a particular entry by specifying its ID. |
| inventory_serial_lots_findD | Find Inventory Serial/Lot information. |
| inventory_serial_lots_getB | Get the Inventory Serial/Lot information for a particular entry by specifying its ID. |
| inventory_in_transit_findD | Find Inventory In Transit information. |
| inventory_in_transit_getB | Get the Inventory In Transit information for a particular entry by specifying its ID. |
| inventory_feature_options_findC | Find Feature Options (for configurable/kit items). |
| inventory_feature_options_getC | Get the Feature Option for a particular entry by specifying its ID. |
| inventory_product_categories_findD | Find Product Categories. |
| inventory_product_categories_getB | Get the Product Category by ID. |
| inventory_substitute_items_findD | Find Substitute Items. |
| inventory_substitute_items_getC | Get the Substitute Item by ID. |
| locations_findC | Find Locations (warehouse/inventory locations). When StockingFilter is true, filtering applies to both Location and InventoryLocation. |
| locations_getC | Get the Location information for a particular entry by specifying its ID. |
| purchase_orders_findD | Find Purchase Orders. |
| purchase_orders_getB | Get the Purchase Order for a particular entry by specifying its ID. |
| purchase_orders_createD | Creates a new Purchase Order. |
| purchase_orders_updateC | Updates the specified Purchase Order with the data provided. |
| purchase_orders_deleteC | Deletes the specific Purchase Order. |
| purchase_order_lines_findD | Find Purchase Order Lines. |
| purchase_order_lines_getB | Get the Purchase Order Line for a particular entry by specifying its ID. |
| purchase_order_lines_createC | Creates a new Purchase Order Line. |
| purchase_order_lines_updateC | Updates the specified Purchase Order Line with the data provided. |
| purchase_order_lines_deleteC | Deletes the specific Purchase Order Line. |
| gl_accounts_findC | Find some or all of the Chart of Accounts (GL Accounts). |
| gl_accounts_getA | Get a single Chart of Account (GL Account) by specifying its ID. |
| gl_cost_centers_findC | Get Cost Centers. GeneralLedgerAccount or CustomerNumber is required. |
| gl_cost_units_findC | Get Cost Units. GeneralLedgerAccount or CustomerNumber is required. |
| price_getC | Gets Price information for the specified Item, Customer, Quantity, date, etc. |
| divisions_findC | Find Division information. Note: the "division" parameter is ignored for this API. |
| divisions_getB | Get one Division's information, given the Division Code. |
| receivable_terms_findD | Find Receivable Accounts Terms. |
| receivable_terms_getB | Get the Receivable Accounts Term for a particular entry by specifying its ID. |
| projects_findC | Find Projects (Jobs). |
| projects_getA | Get the Project (Job) for a particular entry by specifying its ID. |
| job_titles_findD | Find Job Titles. |
| job_titles_getB | Get the Job Title for a particular entry by specifying its ID. |
| titles_findC | Find Titles (salutation lookup values, e.g. Mr., Mrs., Dr.). |
| titles_getB | Get the Title for a particular entry by specifying its ID. |
| tax_codes_findD | Find Tax Codes. |
| tax_codes_getA | Get the Tax Code for a particular entry by specifying its ID. |
| tax_schedules_findD | Find Tax Schedules. |
| tax_schedules_getB | Get the Tax Schedule for a particular entry by specifying its ID. |
| shop_floor_orders_findC | Find Shop Floor Orders (manufacturing work orders). |
| shop_floor_orders_getB | Get the Shop Floor Order for a particular entry by specifying its ID. |
| shop_floor_orders_createC | Creates a new Shop Floor Order (manufacturing work order). |
| standard_routing_findC | Find Standard Routings (manufacturing routing templates). |
| standard_routing_getA | Get the Standard Routing for a particular entry by specifying its ID. |
| standard_routing_createD | Creates a new Standard Routing. |
| forecast_pro_exportC | Export history data from Macola as a CSV file that can be imported into Forecast Pro TRAC. |
| forecast_pro_importA | UNTESTED - do not use without checking first. Import a Forecast Pro TRAC XML forecast file into Macola for a given Calendar Number and optionally a specific Location. (The API spec documents the XML as a required "request" parameter; this tool sends it as the body.) |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 88 tools
Most tools target distinct resources and actions, but the large surface creates several close pairs such as locations_find/locations_get versus inventory_locations_find/inventory_locations_get, and addresses_find versus addresses_address_book. Descriptions help, but an agent must carefully distinguish many find/get pairs across similar ERP entities.
The dominant convention is clear snake_case with an entity prefix followed by an action (addresses_find, purchase_orders_create, inventory_items_get). There are minor deviations such as singular/plural inconsistencies (purchase_orders vs purchase_order_lines, standard_routing), awkward names like addresses_address_book, and special action names like customer_orders_remove_credit_hold.
With 88 tools, the server is far beyond a practical MCP tool surface and will be difficult for an agent to navigate efficiently. Although the ERP domain is broad, the set is bloated with many repetitive find/get pairs and would benefit from consolidation or resource-oriented grouping.
Core sales, purchasing, inventory, and contact/address workflows are broadly covered, with several resources supporting full CRUD. However, many resources are read-only or partially covered, such as inventory_items, projects, shop_floor_orders, locations, and tax codes, leaving notable lifecycle gaps.