@stubbedev/trimit-mcp 0.1.0

package/dist/categories/salesdocs.js

@@ -0,0 +1,395 @@
+import { z } from "zod";
+import { TRIMIT_AUTH, buildHeaders, buildOdataQuery, fetchExample, trimitBase } from "../common.js";
+const CATEGORY = "salesdocs";
+const DOC_TYPES = ["Quote", "Order", "Invoice", "Credit Memo", "Blanket Order", "Return Order"];
+export const salesdocsTools = [
+    {
+        name: "trimit_salesdocs_list",
+        description: "List all sales documents currently in the TRIMIT Sales Import Journal (Quote/Order/Invoice/Credit Memo/Blanket Order/Return Order, both unprocessed and processed).",
+        category: CATEGORY,
+        zodShape: {
+            filter: z.string().optional(),
+            select: z.array(z.string()).optional(),
+            expand: z
+                .string()
+                .optional()
+                .describe("Default: 'salesDocumentLines($expand=additionalFields),additionalFields'"),
+            top: z.number().optional(),
+            skip: z.number().optional(),
+        },
+        handler: (args) => {
+            const expand = args.expand ?? "salesDocumentLines($expand=additionalFields),additionalFields";
+            const { qs, params } = buildOdataQuery({ ...args, expand });
+            const endpoint = `${trimitBase()}/salesDocuments${qs}`;
+            return {
+                endpoint,
+                method: "GET",
+                headers: buildHeaders(),
+                pathParams: { tenant: "{tenant}", environment: "{environment}", companyId: "{companyId}" },
+                queryParams: params,
+                body: null,
+                description: "All open sales documents.",
+                docsUrl: "https://apidocs.trimit.com/",
+                codeExample: fetchExample(endpoint, "GET", null),
+                auth: TRIMIT_AUTH,
+                notes: "Use the exportedDocuments helpers (category 'exported') to mark a doc as exported and exclude it from this list on future polls.",
+            };
+        },
+    },
+    {
+        name: "trimit_salesdocs_list_processed",
+        description: "List sales documents that have been processed (imported into BC). Filters processedDate > 0001-01-01.",
+        category: CATEGORY,
+        zodShape: {
+            extraFilter: z.string().optional().describe("Additional OData $filter ANDed with the processed filter"),
+            expand: z.string().optional(),
+            top: z.number().optional(),
+            skip: z.number().optional(),
+        },
+        handler: (args) => {
+            const filter = args.extraFilter
+                ? `(processedDate gt 0001-01-01) and (${args.extraFilter})`
+                : `(processedDate gt 0001-01-01)`;
+            const expand = args.expand ?? "salesDocumentLines($expand=additionalFields),additionalFields";
+            const { qs, params } = buildOdataQuery({ filter, expand, top: args.top, skip: args.skip });
+            const endpoint = `${trimitBase()}/salesDocuments()${qs}`;
+            return {
+                endpoint,
+                method: "GET",
+                headers: buildHeaders(),
+                pathParams: { tenant: "{tenant}", environment: "{environment}", companyId: "{companyId}" },
+                queryParams: params,
+                body: null,
+                description: "Sales documents that have been imported into BC.",
+                docsUrl: "https://apidocs.trimit.com/",
+                codeExample: fetchExample(endpoint, "GET", null),
+                auth: TRIMIT_AUTH,
+                notes: null,
+            };
+        },
+    },
+    {
+        name: "trimit_salesdocs_get_processed_one",
+        description: "Get one processed sales document by systemId.",
+        category: CATEGORY,
+        zodShape: {
+            systemId: z.string().describe("Document systemId (GUID)"),
+            expand: z.string().optional(),
+        },
+        handler: (args) => {
+            const expand = args.expand ?? "salesDocumentLines($expand=additionalFields),additionalFields";
+            const { qs, params } = buildOdataQuery({ expand });
+            const endpoint = `${trimitBase()}/salesDocuments(${args.systemId})${qs}`;
+            return {
+                endpoint,
+                method: "GET",
+                headers: buildHeaders(),
+                pathParams: { tenant: "{tenant}", environment: "{environment}", companyId: "{companyId}", systemId: args.systemId },
+                queryParams: params,
+                body: null,
+                description: "Single sales document by GUID.",
+                docsUrl: "https://apidocs.trimit.com/",
+                codeExample: fetchExample(endpoint, "GET", null),
+                auth: TRIMIT_AUTH,
+                notes: null,
+            };
+        },
+    },
+    {
+        name: "trimit_salesdocs_list_orders",
+        description: "List sales orders only.",
+        category: CATEGORY,
+        zodShape: {
+            filter: z.string().optional(),
+            expand: z.string().optional(),
+            top: z.number().optional(),
+            skip: z.number().optional(),
+        },
+        handler: (args) => {
+            const expand = args.expand ?? "salesOrderLines($expand=additionalFields),additionalFields";
+            const { qs, params } = buildOdataQuery({ ...args, expand });
+            const endpoint = `${trimitBase()}/salesOrders${qs}`;
+            return {
+                endpoint,
+                method: "GET",
+                headers: buildHeaders(),
+                pathParams: { tenant: "{tenant}", environment: "{environment}", companyId: "{companyId}" },
+                queryParams: params,
+                body: null,
+                description: "Sales orders list.",
+                docsUrl: "https://apidocs.trimit.com/",
+                codeExample: fetchExample(endpoint, "GET", null),
+                auth: TRIMIT_AUTH,
+                notes: null,
+            };
+        },
+    },
+    {
+        name: "trimit_salesdocs_list_invoices",
+        description: "List unposted sales invoices.",
+        category: CATEGORY,
+        zodShape: {
+            filter: z.string().optional(),
+            expand: z.string().optional(),
+            top: z.number().optional(),
+            skip: z.number().optional(),
+        },
+        handler: (args) => {
+            const expand = args.expand ?? "salesInvoiceLines($expand=additionalFields),additionalFields";
+            const { qs, params } = buildOdataQuery({ ...args, expand });
+            const endpoint = `${trimitBase()}/salesInvoices${qs}`;
+            return {
+                endpoint,
+                method: "GET",
+                headers: buildHeaders(),
+                pathParams: { tenant: "{tenant}", environment: "{environment}", companyId: "{companyId}" },
+                queryParams: params,
+                body: null,
+                description: "Unposted sales invoices.",
+                docsUrl: "https://apidocs.trimit.com/",
+                codeExample: fetchExample(endpoint, "GET", null),
+                auth: TRIMIT_AUTH,
+                notes: "Posted invoices live under category 'postedsales'.",
+            };
+        },
+    },
+    {
+        name: "trimit_salesdocs_list_credit_memos",
+        description: "List unposted sales credit memos.",
+        category: CATEGORY,
+        zodShape: {
+            filter: z.string().optional(),
+            expand: z.string().optional(),
+            top: z.number().optional(),
+            skip: z.number().optional(),
+        },
+        handler: (args) => {
+            const expand = args.expand ?? "salesCreditMemoLines($expand=additionalFields),additionalFields";
+            const { qs, params } = buildOdataQuery({ ...args, expand });
+            const endpoint = `${trimitBase()}/salesCreditMemos${qs}`;
+            return {
+                endpoint,
+                method: "GET",
+                headers: buildHeaders(),
+                pathParams: { tenant: "{tenant}", environment: "{environment}", companyId: "{companyId}" },
+                queryParams: params,
+                body: null,
+                description: "Unposted credit memos.",
+                docsUrl: "https://apidocs.trimit.com/",
+                codeExample: fetchExample(endpoint, "GET", null),
+                auth: TRIMIT_AUTH,
+                notes: null,
+            };
+        },
+    },
+    {
+        name: "trimit_salesdocs_list_return_orders",
+        description: "List sales return orders. Only returns orders **created via this API** are visible here.",
+        category: CATEGORY,
+        zodShape: {
+            filter: z.string().optional(),
+            expand: z.string().optional(),
+            top: z.number().optional(),
+            skip: z.number().optional(),
+        },
+        handler: (args) => {
+            const expand = args.expand ?? "salesReturnOrderLines($expand=additionalFields),additionalFields";
+            const { qs, params } = buildOdataQuery({ ...args, expand });
+            const endpoint = `${trimitBase()}/salesReturnOrders${qs}`;
+            return {
+                endpoint,
+                method: "GET",
+                headers: buildHeaders(),
+                pathParams: { tenant: "{tenant}", environment: "{environment}", companyId: "{companyId}" },
+                queryParams: params,
+                body: null,
+                description: "Sales return orders (API-created only).",
+                docsUrl: "https://apidocs.trimit.com/",
+                codeExample: fetchExample(endpoint, "GET", null),
+                auth: TRIMIT_AUTH,
+                notes: "Return orders created directly in the BC client are not surfaced here — by design. To see all posted return receipts use trimit_postedsales_list_return_receipts.",
+            };
+        },
+    },
+    {
+        name: "trimit_salesdocs_create_return_order",
+        description: "Create a sales return order.",
+        category: CATEGORY,
+        zodShape: {
+            returnOrderNo: z.string(),
+            sellToCustomerNo: z.string().optional(),
+            SellToCustomerName: z.string().optional(),
+            sellToEmail: z.string().optional(),
+            selltoPhoneNo: z.string().optional(),
+            orderDate: z.string().describe("YYYY-MM-DD"),
+            releaseDocument: z.boolean().optional(),
+            additionalFields: z
+                .array(z.object({ number: z.string().optional(), name: z.string(), value: z.string() }))
+                .optional(),
+            salesReturnOrderLines: z
+                .array(z.object({
+                lineNo: z.number(),
+                type: z.string().describe("Usually 'Item'"),
+                no: z.string().describe("Item number"),
+                unitPrice: z.number(),
+                quantity: z.number(),
+                locationCode: z.string().optional(),
+                additionalFields: z
+                    .array(z.object({ name: z.string(), value: z.string() }))
+                    .optional(),
+            }))
+                .min(1),
+        },
+        handler: (args) => {
+            const expand = "salesReturnOrderLines($expand=additionalFields),additionalFields";
+            const { qs, params } = buildOdataQuery({ expand });
+            const endpoint = `${trimitBase()}/salesReturnOrders${qs}`;
+            const body = Object.fromEntries(Object.entries(args).filter(([, v]) => v !== undefined));
+            return {
+                endpoint,
+                method: "POST",
+                headers: buildHeaders(),
+                pathParams: { tenant: "{tenant}", environment: "{environment}", companyId: "{companyId}" },
+                queryParams: params,
+                body,
+                description: "Create a return order.",
+                docsUrl: "https://apidocs.trimit.com/",
+                codeExample: fetchExample(endpoint, "POST", body),
+                auth: TRIMIT_AUTH,
+                notes: "releaseDocument=true releases the return order in BC immediately. additionalFields on header and line write to configuredFields tables.",
+            };
+        },
+    },
+    {
+        name: "trimit_salesdocs_post_add_fields",
+        description: "Append lines / set additionalFields on an existing sales document. Variant of /salesDocuments POST that targets an already-existing docType+docNo.",
+        category: CATEGORY,
+        zodShape: {
+            docType: z.enum(DOC_TYPES),
+            docNo: z.string(),
+            SellToCustomerName: z.string().optional(),
+            orderDate: z.string().optional().describe("YYYY-MM-DD"),
+            releaseDocument: z.boolean().optional(),
+            additionalFields: z
+                .array(z.object({ name: z.string(), value: z.string() }))
+                .optional(),
+            salesDocumentLines: z
+                .array(z.object({
+                lineNo: z.number().optional(),
+                type: z.string().describe("'Item', 'G/L Account', etc."),
+                no: z.string(),
+                unitPrice: z.number().optional(),
+                quantity: z.number().optional(),
+                unitOfMeasureCode: z.string().optional(),
+                locationCode: z.string().optional(),
+                periodCode: z.string().optional(),
+                discountAmount: z.number().optional(),
+                additionalFields: z.array(z.object({ name: z.string(), value: z.string() })).optional(),
+            }))
+                .optional(),
+        },
+        handler: (args) => {
+            const endpoint = `${trimitBase()}/salesDocuments`;
+            const body = Object.fromEntries(Object.entries(args).filter(([, v]) => v !== undefined));
+            return {
+                endpoint,
+                method: "POST",
+                headers: buildHeaders(),
+                pathParams: { tenant: "{tenant}", environment: "{environment}", companyId: "{companyId}" },
+                queryParams: {},
+                body,
+                description: "Append fields/lines to an existing sales document.",
+                docsUrl: "https://apidocs.trimit.com/",
+                codeExample: fetchExample(endpoint, "POST", body),
+                auth: TRIMIT_AUTH,
+                notes: "Same endpoint URL as create — the server distinguishes 'add fields' vs 'create' by whether docNo already exists. Use trimit_salesdocs_create for new docs to keep intent explicit.",
+            };
+        },
+    },
+    {
+        name: "trimit_salesdocs_create",
+        description: "Create a new sales document (Quote / Order / Invoice / Credit Memo / Blanket Order / Return Order) with one or more lines.",
+        category: CATEGORY,
+        zodShape: {
+            docType: z.enum(DOC_TYPES),
+            docNo: z.string().describe("Customer-facing document number (unique per docType)"),
+            sellToCustomerNo: z.string().describe("BC customer number, e.g. '10000'"),
+            orderDate: z.string().describe("YYYY-MM-DD"),
+            releaseDocument: z.boolean().optional().describe("Release the doc in BC on create."),
+            additionalFields: z
+                .array(z.object({ name: z.string(), value: z.string() }))
+                .optional(),
+            salesDocumentLines: z
+                .array(z.object({
+                type: z.string().describe("'Item', 'G/L Account', 'Resource', 'Fixed Asset', 'Charge (Item)'"),
+                no: z.string().describe("Item number / G/L account / etc."),
+                unitPrice: z.number(),
+                quantity: z.number(),
+                unitOfMeasureCode: z.string().optional(),
+                locationCode: z.string().optional(),
+                periodCode: z.string().optional(),
+                discountAmount: z.number().optional(),
+                additionalFields: z
+                    .array(z.object({ name: z.string(), value: z.string() }))
+                    .optional(),
+            }))
+                .min(1),
+        },
+        handler: (args) => {
+            const endpoint = `${trimitBase()}/salesDocuments`;
+            const body = Object.fromEntries(Object.entries(args).filter(([, v]) => v !== undefined));
+            return {
+                endpoint,
+                method: "POST",
+                headers: buildHeaders(),
+                pathParams: { tenant: "{tenant}", environment: "{environment}", companyId: "{companyId}" },
+                queryParams: {},
+                body,
+                description: "Create a sales document.",
+                docsUrl: "https://apidocs.trimit.com/",
+                codeExample: fetchExample(endpoint, "POST", body),
+                auth: TRIMIT_AUTH,
+                notes: "201 returns the created entity with @odata.etag and systemId. Use trimit_salesdocs_post_lines_batch to push many docs in a single round-trip.",
+            };
+        },
+    },
+    {
+        name: "trimit_salesdocs_post_lines_batch",
+        description: "Bulk-create sales documents / lines via OData $batch. Pass any number of POST requests; one round-trip.",
+        category: CATEGORY,
+        zodShape: {
+            requests: z
+                .array(z.object({
+                method: z.literal("POST"),
+                url: z.string().describe("Relative URL, e.g. companies({id})/salesDocumentLines"),
+                body: z.record(z.string(), z.unknown()),
+                headers: z.record(z.string(), z.string()).optional(),
+            }))
+                .min(1),
+        },
+        handler: (args) => {
+            const endpoint = `${trimitBase()}/$batch`;
+            const body = {
+                requests: args.requests.map((r) => ({
+                    method: r.method,
+                    url: r.url,
+                    body: r.body,
+                    headers: r.headers ?? { "Content-Type": "application/json" },
+                })),
+            };
+            return {
+                endpoint,
+                method: "POST",
+                headers: buildHeaders(),
+                pathParams: { tenant: "{tenant}", environment: "{environment}", companyId: "{companyId}" },
+                queryParams: {},
+                body,
+                description: "Batch sales document creates.",
+                docsUrl: "https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/webservices/odata-using-batch",
+                codeExample: fetchExample(endpoint, "POST", body),
+                auth: TRIMIT_AUTH,
+                notes: "BC $batch envelope follows the OData v4 JSON batch spec. The whole batch fails together only if framing is invalid; individual requests get their own status. Each sub-URL is relative to the OData service root.",
+            };
+        },
+    },
+];

package/dist/categories/standard.js

@@ -0,0 +1,228 @@
+import { z } from "zod";
+import { HOST, STD_API_PATH, TRIMIT_API_PATH, TRIMIT_AUTH, buildHeaders, buildOdataQuery, fetchExample, stdBase, stdRoot, tenantRoot, } from "../common.js";
+const CATEGORY = "standard";
+export const standardTools = [
+    {
+        name: "trimit_std_get_companies",
+        description: "List Business Central companies in the tenant (Standard MS API). Returns each company id GUID — required for every TRIMIT call.",
+        category: CATEGORY,
+        zodShape: {
+            filter: z.string().optional().describe("OData $filter expression"),
+            select: z.array(z.string()).optional().describe("Fields to return"),
+        },
+        handler: (args) => {
+            const { qs, params } = buildOdataQuery({ filter: args.filter, select: args.select });
+            const endpoint = `${stdRoot()}/companies${qs}`;
+            return {
+                endpoint,
+                method: "GET",
+                headers: buildHeaders(),
+                pathParams: { tenant: "{tenant}", environment: "{environment}" },
+                queryParams: params,
+                body: null,
+                description: "List BC companies via the standard MS BC API. Use a company id with every other TRIMIT call.",
+                docsUrl: "https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/api-reference/v2.0/api/dynamics_company",
+                codeExample: fetchExample(endpoint, "GET", null),
+                auth: TRIMIT_AUTH,
+                notes: "Standard BC API base path is /api/v2.0; this does NOT live under the TRIMIT integration path. Response is OData v4 JSON: { '@odata.context': ..., value: [{ id, name, displayName, ... }] }.",
+            };
+        },
+    },
+    {
+        name: "trimit_std_get_companies_odata",
+        description: "List companies via the BC OData v4 endpoint (parallel to the Standard API). Returns the same data via OData.",
+        category: CATEGORY,
+        zodShape: {
+            filter: z.string().optional(),
+            select: z.array(z.string()).optional(),
+            top: z.number().optional(),
+            skip: z.number().optional(),
+        },
+        handler: (args) => {
+            const { qs, params } = buildOdataQuery(args);
+            const endpoint = `${tenantRoot()}/ODataV4/Company${qs}`;
+            return {
+                endpoint,
+                method: "GET",
+                headers: buildHeaders(),
+                pathParams: { tenant: "{tenant}", environment: "{environment}" },
+                queryParams: params,
+                body: null,
+                description: "OData v4 view of companies.",
+                docsUrl: "https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/webservices/odata-web-services",
+                codeExample: fetchExample(endpoint, "GET", null),
+                auth: TRIMIT_AUTH,
+                notes: "OData endpoint is /ODataV4 (not /api/...). Useful for legacy OData clients.",
+            };
+        },
+    },
+    {
+        name: "trimit_std_get_items",
+        description: "List items via the Standard MS BC API (BC built-in Item table — not the TRIMIT-enriched item resource).",
+        category: CATEGORY,
+        zodShape: {
+            filter: z.string().optional(),
+            select: z.array(z.string()).optional(),
+            expand: z.string().optional(),
+            top: z.number().optional(),
+            skip: z.number().optional(),
+        },
+        handler: (args) => {
+            const { qs, params } = buildOdataQuery(args);
+            const endpoint = `${stdBase()}/items${qs}`;
+            return {
+                endpoint,
+                method: "GET",
+                headers: buildHeaders(),
+                pathParams: { tenant: "{tenant}", environment: "{environment}", companyId: "{companyId}" },
+                queryParams: params,
+                body: null,
+                description: "Standard BC items list.",
+                docsUrl: "https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/api-reference/v2.0/api/dynamics_item",
+                codeExample: fetchExample(endpoint, "GET", null),
+                auth: TRIMIT_AUTH,
+                notes: "For TRIMIT-extended items (variants, master link, extended descriptions) use trimit_products_get_items instead.",
+            };
+        },
+    },
+    {
+        name: "trimit_std_get_customers",
+        description: "List customers via the Standard MS BC API with default dimensions expanded.",
+        category: CATEGORY,
+        zodShape: {
+            filter: z.string().optional(),
+            select: z.array(z.string()).optional(),
+            expand: z
+                .string()
+                .optional()
+                .describe("OData $expand; defaults to 'defaultDimensions' if omitted"),
+            top: z.number().optional(),
+            skip: z.number().optional(),
+        },
+        handler: (args) => {
+            const expand = args.expand ?? "defaultDimensions";
+            const { qs, params } = buildOdataQuery({ ...args, expand });
+            const endpoint = `${stdBase()}/customers${qs}`;
+            return {
+                endpoint,
+                method: "GET",
+                headers: buildHeaders(),
+                pathParams: { tenant: "{tenant}", environment: "{environment}", companyId: "{companyId}" },
+                queryParams: params,
+                body: null,
+                description: "List BC customers with default dimensions.",
+                docsUrl: "https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/api-reference/v2.0/api/dynamics_customer",
+                codeExample: fetchExample(endpoint, "GET", null),
+                auth: TRIMIT_AUTH,
+                notes: "Use trimit_customers_list for the TRIMIT-enriched customer resource (picture, priceGroupParameters, contactsInformation, configuredFields, etc.).",
+            };
+        },
+    },
+    {
+        name: "trimit_std_patch_customer",
+        description: "Patch a customer's default dimensions via the Standard MS BC API. Requires If-Match header for OData concurrency control.",
+        category: CATEGORY,
+        zodShape: {
+            customerId: z.string().describe("Customer systemId GUID"),
+            ifMatch: z.string().default("*").describe("ETag for OData concurrency. '*' = unconditional."),
+            defaultDimensions: z
+                .array(z.object({
+                parentType: z.literal("Customer"),
+                parentId: z.string(),
+                dimensionCode: z.string(),
+                dimensionValueCode: z.string(),
+            }))
+                .describe("Default dimension assignments"),
+        },
+        handler: (args) => {
+            const endpoint = `${stdBase()}/customers(${args.customerId})?$expand=defaultDimensions`;
+            const body = { defaultDimensions: args.defaultDimensions };
+            const headers = buildHeaders({ "If-Match": args.ifMatch ?? "*" });
+            return {
+                endpoint,
+                method: "PATCH",
+                headers,
+                pathParams: { tenant: "{tenant}", environment: "{environment}", companyId: "{companyId}", customerId: args.customerId },
+                queryParams: { $expand: "defaultDimensions" },
+                body,
+                description: "Patch customer default dimensions.",
+                docsUrl: "https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/api-reference/v2.0/api/dynamics_customer_update",
+                codeExample: fetchExample(endpoint, "PATCH", body, { "If-Match": args.ifMatch ?? "*" }),
+                auth: TRIMIT_AUTH,
+                notes: "BC OData requires If-Match for PATCH. Use '*' for unconditional update or the resource @odata.etag value for optimistic concurrency.",
+            };
+        },
+    },
+    {
+        name: "trimit_std_get_metadata",
+        description: "Get the CSDL/EDMX metadata document for the Standard MS BC API ($metadata).",
+        category: CATEGORY,
+        zodShape: {},
+        handler: () => {
+            const endpoint = `${HOST}/{tenant}/{environment}/${STD_API_PATH}/$metadata`;
+            return {
+                endpoint,
+                method: "GET",
+                headers: buildHeaders({ Accept: "application/xml" }),
+                pathParams: { tenant: "{tenant}", environment: "{environment}" },
+                queryParams: {},
+                body: null,
+                description: "Standard BC API $metadata (XML).",
+                docsUrl: "https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/api-reference/v2.0/",
+                codeExample: fetchExample(endpoint, "GET", null, { Accept: "application/xml" }),
+                auth: TRIMIT_AUTH,
+                notes: "Use for client codegen (e.g. odata2ts, openapi-from-edmx). Returns XML, not JSON.",
+            };
+        },
+    },
+    {
+        name: "trimit_std_get_metadata_odata",
+        description: "Get the CSDL/EDMX metadata document for the BC OData v4 endpoint.",
+        category: CATEGORY,
+        zodShape: {},
+        handler: () => {
+            const endpoint = `${tenantRoot()}/ODataV4/$metadata`;
+            return {
+                endpoint,
+                method: "GET",
+                headers: buildHeaders({ Accept: "application/xml" }),
+                pathParams: { tenant: "{tenant}", environment: "{environment}" },
+                queryParams: {},
+                body: null,
+                description: "Metadata for the BC ODataV4 endpoint (different from the /api/v2.0 metadata).",
+                docsUrl: "https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/webservices/odata-web-services",
+                codeExample: fetchExample(endpoint, "GET", null, { Accept: "application/xml" }),
+                auth: TRIMIT_AUTH,
+                notes: null,
+            };
+        },
+    },
+    {
+        name: "trimit_std_get_entity_definitions",
+        description: "List entity definitions in the Standard MS BC API.",
+        category: CATEGORY,
+        zodShape: {},
+        handler: () => {
+            const endpoint = `${HOST}/{tenant}/{environment}/${STD_API_PATH}/entityDefinitions`;
+            return {
+                endpoint,
+                method: "GET",
+                headers: buildHeaders(),
+                pathParams: { tenant: "{tenant}", environment: "{environment}" },
+                queryParams: {},
+                body: null,
+                description: "Discover entity definitions (BC entity schema introspection).",
+                docsUrl: "https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/api-reference/v2.0/",
+                codeExample: fetchExample(endpoint, "GET", null),
+                auth: TRIMIT_AUTH,
+                notes: null,
+            };
+        },
+    },
+];
+// Re-export base paths for help tools
+export const _STANDARD_BASES = {
+    std: STD_API_PATH,
+    trimit: TRIMIT_API_PATH,
+    host: HOST,
+};