@knowall-ai/mcp-business-central 0.1.0

package/README.md

@@ -0,0 +1,233 @@
+# Microsoft Business Central MCP Server
+
+<img width="1536" height="1024" alt="mcp-business-central" src="https://github.com/user-attachments/assets/13932bfd-a5b9-4668-a7cd-ac9549a09673" />
+
+Model Context Protocol (MCP) server for Microsoft Dynamics 365 Business Central. Provides AI assistants with direct access to Business Central data through properly formatted API v2.0 calls.
+
+## Features
+
+- ✅ **Correct API URLs**: Uses proper `/companies(id)/resource` format (no ODataV4 segment)
+- ✅ **Zero Installation**: Run with `npx` - no pre-installation required
+- ✅ **Azure CLI Auth**: Leverages existing Azure CLI authentication
+- ✅ **Clean Tool Names**: No prefixes, just `get_schema`, `list_items`, etc.
+- ✅ **Full CRUD**: Create, read, update, and delete Business Central records
+
+## Installation
+
+### Using npx (Recommended)
+
+No installation needed! Configure in Claude Desktop or Claude Code:
+
+```json
+{
+  "mcpServers": {
+    "business-central": {
+      "type": "stdio",
+      "command": "cmd",
+      "args": ["/c", "npx", "-y", "@knowall-ai/mcp-business-central"],
+      "env": {
+        "BC_URL_SERVER": "https://api.businesscentral.dynamics.com/v2.0/{tenant-id}/{environment}/api/v2.0",
+        "BC_COMPANY": "Your Company Name",
+        "BC_AUTH_TYPE": "azure_cli"
+      }
+    }
+  }
+}
+```
+
+**Note for Windows**: Use `cmd` with `/c` as shown above for proper npx execution.
+
+### Local Development
+
+```bash
+git clone https://github.com/knowall-ai/mcp-business-central.git
+cd mcp-business-central
+npm install
+npm run build
+node build/index.js
+```
+
+## Configuration
+
+### Environment Variables
+
+| Variable | Required | Description | Example |
+|----------|----------|-------------|---------|
+| `BC_URL_SERVER` | Yes | Business Central API base URL | `https://api.businesscentral.dynamics.com/v2.0/{tenant}/Production/api/v2.0` |
+| `BC_COMPANY` | Yes | Company display name | `KnowAll Ltd` |
+| `BC_AUTH_TYPE` | No | Authentication type (default: `azure_cli`) | `azure_cli` |
+
+### Getting Your Configuration Values
+
+1. **Tenant ID**: Find in Azure Portal → Azure Active Directory → Overview
+2. **Environment**: Usually `Production` or `Sandbox`
+3. **Company Name**: The display name shown in Business Central
+
+Example URL format:
+```
+https://api.businesscentral.dynamics.com/v2.0/f36f6414-cb7d-4545-9cf2-7574f7b5c584/Production/api/v2.0
+```
+
+## Prerequisites
+
+- **Azure CLI**: Must be installed and authenticated
+  - Install: https://docs.microsoft.com/cli/azure/install-azure-cli
+  - Login: `az login`
+  - Get token: `az account get-access-token --resource https://api.businesscentral.dynamics.com`
+
+## Available Tools
+
+### 1. `get_schema`
+Get OData metadata for a Business Central resource.
+
+**Parameters:**
+- `resource` (string, required): Resource name (e.g., `customers`, `contacts`, `salesOpportunities`)
+
+**Example:**
+```json
+{
+  "resource": "customers"
+}
+```
+
+### 2. `list_items`
+List items with optional filtering and pagination.
+
+**Parameters:**
+- `resource` (string, required): Resource name
+- `filter` (string, optional): OData filter expression
+- `top` (number, optional): Maximum number of items to return
+- `skip` (number, optional): Number of items to skip for pagination
+
+**Example:**
+```json
+{
+  "resource": "customers",
+  "filter": "displayName eq 'Contoso'",
+  "top": 10
+}
+```
+
+### 3. `get_items_by_field`
+Get items matching a specific field value.
+
+**Parameters:**
+- `resource` (string, required): Resource name
+- `field` (string, required): Field name to filter by
+- `value` (string, required): Value to match
+
+**Example:**
+```json
+{
+  "resource": "contacts",
+  "field": "companyName",
+  "value": "Contoso Ltd"
+}
+```
+
+### 4. `create_item`
+Create a new item in Business Central.
+
+**Parameters:**
+- `resource` (string, required): Resource name
+- `item_data` (object, required): Item data to create
+
+**Example:**
+```json
+{
+  "resource": "contacts",
+  "item_data": {
+    "displayName": "John Doe",
+    "companyName": "Contoso Ltd",
+    "email": "john.doe@contoso.com"
+  }
+}
+```
+
+### 5. `update_item`
+Update an existing item.
+
+**Parameters:**
+- `resource` (string, required): Resource name
+- `item_id` (string, required): Item ID (GUID)
+- `item_data` (object, required): Fields to update
+
+**Example:**
+```json
+{
+  "resource": "customers",
+  "item_id": "1366066e-7688-f011-b9d1-6045bde9b95f",
+  "item_data": {
+    "displayName": "Updated Name"
+  }
+}
+```
+
+### 6. `delete_item`
+Delete an item from Business Central.
+
+**Parameters:**
+- `resource` (string, required): Resource name
+- `item_id` (string, required): Item ID (GUID)
+
+**Example:**
+```json
+{
+  "resource": "contacts",
+  "item_id": "a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6"
+}
+```
+
+## Common Resources
+
+- `companies` - Company information
+- `customers` - Customer records
+- `contacts` - Contact records
+- `salesOpportunities` - Sales opportunities
+- `salesQuotes` - Sales quotes
+- `salesOrders` - Sales orders
+- `salesInvoices` - Sales invoices
+- `items` - Product/service items
+- `vendors` - Vendor records
+
+## Troubleshooting
+
+### 401 Unauthorized
+- Ensure Azure CLI is logged in: `az login`
+- Verify you have access to Business Central in your tenant
+- Test token retrieval: `az account get-access-token --resource https://api.businesscentral.dynamics.com`
+
+### Company Not Found
+- Check company name matches exactly (case-sensitive)
+- Verify company exists: Access Business Central web UI
+- Ensure URL includes correct tenant ID and environment
+
+### Resource Not Found
+- Check resource name spelling (e.g., `customers` not `customer`)
+- Some resources may not be available in your Business Central version
+- Use `get_schema` to explore available resources
+
+## Development
+
+```bash
+# Install dependencies
+npm install
+
+# Build TypeScript
+npm run build
+
+# Watch mode for development
+npm run dev
+```
+
+## License
+
+MIT
+
+## Contributing
+
+Issues and pull requests welcome at https://github.com/knowall-ai/mcp-business-central
+
+## Related Projects
+
+- MCP Specification: [modelcontextprotocol.io](https://modelcontextprotocol.io)

package/build/business-central-client.d.ts

@@ -0,0 +1,59 @@
+export interface BusinessCentralConfig {
+    serverUrl: string;
+    companyName: string;
+    authType: 'azure_cli';
+}
+export interface Company {
+    id: string;
+    systemVersion: string;
+    timestamp: number;
+    name: string;
+    displayName: string;
+    businessProfileId: string;
+    systemCreatedAt: string;
+    systemCreatedBy: string;
+    systemModifiedAt: string;
+    systemModifiedBy: string;
+}
+export declare class BusinessCentralClient {
+    private config;
+    private companyId?;
+    private credential?;
+    constructor(config: BusinessCentralConfig);
+    /**
+     * Get the company ID by looking up the company name
+     */
+    private getCompanyId;
+    /**
+     * Make an authenticated request to Business Central API
+     */
+    private request;
+    /**
+     * Get OData metadata for a resource
+     */
+    getSchema(resource: string): Promise<any>;
+    /**
+     * List items from a resource with optional filtering and pagination
+     */
+    listItems(resource: string, options?: {
+        filter?: string;
+        top?: number;
+        skip?: number;
+    }): Promise<any>;
+    /**
+     * Get items by field value
+     */
+    getItemsByField(resource: string, field: string, value: string): Promise<any>;
+    /**
+     * Create a new item
+     */
+    createItem(resource: string, data: any): Promise<any>;
+    /**
+     * Update an existing item
+     */
+    updateItem(resource: string, itemId: string, data: any): Promise<any>;
+    /**
+     * Delete an item
+     */
+    deleteItem(resource: string, itemId: string): Promise<void>;
+}

package/build/business-central-client.js

@@ -0,0 +1,114 @@
+import { AzureCliCredential } from '@azure/identity';
+export class BusinessCentralClient {
+    config;
+    companyId;
+    credential;
+    constructor(config) {
+        this.config = config;
+        if (config.authType === 'azure_cli') {
+            this.credential = new AzureCliCredential();
+        }
+    }
+    /**
+     * Get the company ID by looking up the company name
+     */
+    async getCompanyId() {
+        if (this.companyId) {
+            return this.companyId;
+        }
+        const url = `${this.config.serverUrl}/companies?$filter=displayName eq '${this.config.companyName}'`;
+        const response = await this.request('GET', url);
+        if (!response.value || response.value.length === 0) {
+            throw new Error(`Company '${this.config.companyName}' not found`);
+        }
+        const companyId = response.value[0].id;
+        this.companyId = companyId;
+        return companyId;
+    }
+    /**
+     * Make an authenticated request to Business Central API
+     */
+    async request(method, url, body) {
+        if (!this.credential) {
+            throw new Error('Authentication not configured');
+        }
+        // Get access token for Business Central
+        const tokenResponse = await this.credential.getToken('https://api.businesscentral.dynamics.com/.default');
+        const headers = {
+            'Authorization': `Bearer ${tokenResponse.token}`,
+            'Content-Type': 'application/json',
+            'Accept': 'application/json'
+        };
+        const options = {
+            method,
+            headers,
+        };
+        if (body) {
+            options.body = JSON.stringify(body);
+        }
+        const response = await fetch(url, options);
+        if (!response.ok) {
+            const errorText = await response.text();
+            throw new Error(`Business Central API error (${response.status}): ${errorText}`);
+        }
+        return response.json();
+    }
+    /**
+     * Get OData metadata for a resource
+     */
+    async getSchema(resource) {
+        const companyId = await this.getCompanyId();
+        const url = `${this.config.serverUrl}/companies(${companyId})/${resource}/$metadata`;
+        return this.request('GET', url);
+    }
+    /**
+     * List items from a resource with optional filtering and pagination
+     */
+    async listItems(resource, options) {
+        const companyId = await this.getCompanyId();
+        let url = `${this.config.serverUrl}/companies(${companyId})/${resource}`;
+        const params = new URLSearchParams();
+        if (options?.filter)
+            params.append('$filter', options.filter);
+        if (options?.top)
+            params.append('$top', options.top.toString());
+        if (options?.skip)
+            params.append('$skip', options.skip.toString());
+        if (params.toString()) {
+            url += `?${params.toString()}`;
+        }
+        return this.request('GET', url);
+    }
+    /**
+     * Get items by field value
+     */
+    async getItemsByField(resource, field, value) {
+        return this.listItems(resource, {
+            filter: `${field} eq '${value}'`
+        });
+    }
+    /**
+     * Create a new item
+     */
+    async createItem(resource, data) {
+        const companyId = await this.getCompanyId();
+        const url = `${this.config.serverUrl}/companies(${companyId})/${resource}`;
+        return this.request('POST', url, data);
+    }
+    /**
+     * Update an existing item
+     */
+    async updateItem(resource, itemId, data) {
+        const companyId = await this.getCompanyId();
+        const url = `${this.config.serverUrl}/companies(${companyId})/${resource}(${itemId})`;
+        return this.request('PATCH', url, data);
+    }
+    /**
+     * Delete an item
+     */
+    async deleteItem(resource, itemId) {
+        const companyId = await this.getCompanyId();
+        const url = `${this.config.serverUrl}/companies(${companyId})/${resource}(${itemId})`;
+        await this.request('DELETE', url);
+    }
+}

package/build/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/build/index.js

@@ -0,0 +1,262 @@
+#!/usr/bin/env node
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { CallToolRequestSchema, ListToolsRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
+import { BusinessCentralClient } from './business-central-client.js';
+// Read configuration from environment variables
+const BC_URL_SERVER = process.env.BC_URL_SERVER;
+const BC_COMPANY = process.env.BC_COMPANY;
+const BC_AUTH_TYPE = process.env.BC_AUTH_TYPE || 'azure_cli';
+if (!BC_URL_SERVER || !BC_COMPANY) {
+    console.error('Error: BC_URL_SERVER and BC_COMPANY environment variables are required');
+    process.exit(1);
+}
+if (BC_AUTH_TYPE !== 'azure_cli') {
+    console.error('Error: Only azure_cli authentication is currently supported');
+    process.exit(1);
+}
+// Create Business Central client
+const bcClient = new BusinessCentralClient({
+    serverUrl: BC_URL_SERVER,
+    companyName: BC_COMPANY,
+    authType: BC_AUTH_TYPE
+});
+// Create MCP server
+const server = new Server({
+    name: 'business-central',
+    version: '0.1.0',
+}, {
+    capabilities: {
+        tools: {},
+    },
+});
+// Register tool handlers
+server.setRequestHandler(ListToolsRequestSchema, async () => {
+    return {
+        tools: [
+            {
+                name: 'get_schema',
+                description: 'Get schema information for a Business Central resource',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        resource: {
+                            type: 'string',
+                            description: 'The resource name (e.g., customers, contacts, salesOpportunities)',
+                        },
+                    },
+                    required: ['resource'],
+                },
+            },
+            {
+                name: 'list_items',
+                description: 'Get items from Business Central with filtering and pagination',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        resource: {
+                            type: 'string',
+                            description: 'The resource name (e.g., customers, contacts, salesOpportunities)',
+                        },
+                        filter: {
+                            type: 'string',
+                            description: 'OData filter expression (optional)',
+                        },
+                        top: {
+                            type: 'number',
+                            description: 'Maximum number of items to return (optional)',
+                        },
+                        skip: {
+                            type: 'number',
+                            description: 'Number of items to skip for pagination (optional)',
+                        },
+                    },
+                    required: ['resource'],
+                },
+            },
+            {
+                name: 'get_items_by_field',
+                description: 'Get items matching a field value',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        resource: {
+                            type: 'string',
+                            description: 'The resource name (e.g., customers, contacts)',
+                        },
+                        field: {
+                            type: 'string',
+                            description: 'The field name to filter by',
+                        },
+                        value: {
+                            type: 'string',
+                            description: 'The value to match',
+                        },
+                    },
+                    required: ['resource', 'field', 'value'],
+                },
+            },
+            {
+                name: 'create_item',
+                description: 'Create a new item in Business Central',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        resource: {
+                            type: 'string',
+                            description: 'The resource name (e.g., customers, contacts)',
+                        },
+                        item_data: {
+                            type: 'object',
+                            description: 'The item data to create',
+                        },
+                    },
+                    required: ['resource', 'item_data'],
+                },
+            },
+            {
+                name: 'update_item',
+                description: 'Update an existing item in Business Central',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        resource: {
+                            type: 'string',
+                            description: 'The resource name (e.g., customers, contacts)',
+                        },
+                        item_id: {
+                            type: 'string',
+                            description: 'The ID of the item to update',
+                        },
+                        item_data: {
+                            type: 'object',
+                            description: 'The item data to update',
+                        },
+                    },
+                    required: ['resource', 'item_id', 'item_data'],
+                },
+            },
+            {
+                name: 'delete_item',
+                description: 'Delete an item from Business Central',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        resource: {
+                            type: 'string',
+                            description: 'The resource name (e.g., customers, contacts)',
+                        },
+                        item_id: {
+                            type: 'string',
+                            description: 'The ID of the item to delete',
+                        },
+                    },
+                    required: ['resource', 'item_id'],
+                },
+            },
+        ],
+    };
+});
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    try {
+        const { name, arguments: args } = request.params;
+        switch (name) {
+            case 'get_schema': {
+                const { resource } = args;
+                const result = await bcClient.getSchema(resource);
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify(result, null, 2),
+                        },
+                    ],
+                };
+            }
+            case 'list_items': {
+                const { resource, filter, top, skip } = args;
+                const result = await bcClient.listItems(resource, { filter, top, skip });
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify(result, null, 2),
+                        },
+                    ],
+                };
+            }
+            case 'get_items_by_field': {
+                const { resource, field, value } = args;
+                const result = await bcClient.getItemsByField(resource, field, value);
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify(result, null, 2),
+                        },
+                    ],
+                };
+            }
+            case 'create_item': {
+                const { resource, item_data } = args;
+                const result = await bcClient.createItem(resource, item_data);
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify(result, null, 2),
+                        },
+                    ],
+                };
+            }
+            case 'update_item': {
+                const { resource, item_id, item_data } = args;
+                const result = await bcClient.updateItem(resource, item_id, item_data);
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify(result, null, 2),
+                        },
+                    ],
+                };
+            }
+            case 'delete_item': {
+                const { resource, item_id } = args;
+                await bcClient.deleteItem(resource, item_id);
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: 'Item deleted successfully',
+                        },
+                    ],
+                };
+            }
+            default:
+                throw new Error(`Unknown tool: ${name}`);
+        }
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Error: ${errorMessage}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+});
+// Start server
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error('Business Central MCP server running on stdio');
+}
+main().catch((error) => {
+    console.error('Server error:', error);
+    process.exit(1);
+});

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "@knowall-ai/mcp-business-central",
+  "version": "0.1.0",
+  "description": "Model Context Protocol server for Microsoft Dynamics 365 Business Central",
+  "type": "module",
+  "bin": {
+    "mcp-business-central": "./build/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "prepare": "npm run build",
+    "dev": "tsc --watch"
+  },
+  "keywords": [
+    "mcp",
+    "business-central",
+    "dynamics-365",
+    "model-context-protocol"
+  ],
+  "author": "KnowAll AI",
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "@azure/identity": "^4.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.0.0"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}

package/smithery.yaml

@@ -0,0 +1,28 @@
+startCommand:
+  type: stdio
+  configSchema:
+    type: object
+    required:
+      - bcServerUrl
+      - bcCompany
+    properties:
+      bcServerUrl:
+        type: string
+        default: "https://api.businesscentral.dynamics.com/v2.0/{tenant}/{environment}/api/v2.0"
+        description: The Business Central API server URL (include tenant and environment).
+      bcCompany:
+        type: string
+        default: ""
+        description: The company name to connect to in Business Central.
+      bcAuthType:
+        type: string
+        default: azure_cli
+        description: Authentication type (currently only azure_cli is supported).
+  commandFunction:
+    config => {
+      const env = {};
+      if (config.bcServerUrl) env.BC_URL_SERVER = config.bcServerUrl;
+      if (config.bcCompany) env.BC_COMPANY = config.bcCompany;
+      if (config.bcAuthType) env.BC_AUTH_TYPE = config.bcAuthType;
+      return {command: 'node', args: ['build/index.js'], env};
+    }

package/src/business-central-client.ts

@@ -0,0 +1,158 @@
+import { AzureCliCredential } from '@azure/identity';
+
+export interface BusinessCentralConfig {
+  serverUrl: string;
+  companyName: string;
+  authType: 'azure_cli';
+}
+
+export interface Company {
+  id: string;
+  systemVersion: string;
+  timestamp: number;
+  name: string;
+  displayName: string;
+  businessProfileId: string;
+  systemCreatedAt: string;
+  systemCreatedBy: string;
+  systemModifiedAt: string;
+  systemModifiedBy: string;
+}
+
+export class BusinessCentralClient {
+  private config: BusinessCentralConfig;
+  private companyId?: string;
+  private credential?: AzureCliCredential;
+
+  constructor(config: BusinessCentralConfig) {
+    this.config = config;
+
+    if (config.authType === 'azure_cli') {
+      this.credential = new AzureCliCredential();
+    }
+  }
+
+  /**
+   * Get the company ID by looking up the company name
+   */
+  private async getCompanyId(): Promise<string> {
+    if (this.companyId) {
+      return this.companyId;
+    }
+
+    const url = `${this.config.serverUrl}/companies?$filter=displayName eq '${this.config.companyName}'`;
+    const response = await this.request('GET', url);
+
+    if (!response.value || response.value.length === 0) {
+      throw new Error(`Company '${this.config.companyName}' not found`);
+    }
+
+    const companyId: string = response.value[0].id;
+    this.companyId = companyId;
+    return companyId;
+  }
+
+  /**
+   * Make an authenticated request to Business Central API
+   */
+  private async request(method: string, url: string, body?: any): Promise<any> {
+    if (!this.credential) {
+      throw new Error('Authentication not configured');
+    }
+
+    // Get access token for Business Central
+    const tokenResponse = await this.credential.getToken('https://api.businesscentral.dynamics.com/.default');
+
+    const headers: Record<string, string> = {
+      'Authorization': `Bearer ${tokenResponse.token}`,
+      'Content-Type': 'application/json',
+      'Accept': 'application/json'
+    };
+
+    const options: RequestInit = {
+      method,
+      headers,
+    };
+
+    if (body) {
+      options.body = JSON.stringify(body);
+    }
+
+    const response = await fetch(url, options);
+
+    if (!response.ok) {
+      const errorText = await response.text();
+      throw new Error(`Business Central API error (${response.status}): ${errorText}`);
+    }
+
+    return response.json();
+  }
+
+  /**
+   * Get OData metadata for a resource
+   */
+  async getSchema(resource: string): Promise<any> {
+    const companyId = await this.getCompanyId();
+    const url = `${this.config.serverUrl}/companies(${companyId})/${resource}/$metadata`;
+    return this.request('GET', url);
+  }
+
+  /**
+   * List items from a resource with optional filtering and pagination
+   */
+  async listItems(resource: string, options?: {
+    filter?: string;
+    top?: number;
+    skip?: number;
+  }): Promise<any> {
+    const companyId = await this.getCompanyId();
+    let url = `${this.config.serverUrl}/companies(${companyId})/${resource}`;
+
+    const params = new URLSearchParams();
+    if (options?.filter) params.append('$filter', options.filter);
+    if (options?.top) params.append('$top', options.top.toString());
+    if (options?.skip) params.append('$skip', options.skip.toString());
+
+    if (params.toString()) {
+      url += `?${params.toString()}`;
+    }
+
+    return this.request('GET', url);
+  }
+
+  /**
+   * Get items by field value
+   */
+  async getItemsByField(resource: string, field: string, value: string): Promise<any> {
+    return this.listItems(resource, {
+      filter: `${field} eq '${value}'`
+    });
+  }
+
+  /**
+   * Create a new item
+   */
+  async createItem(resource: string, data: any): Promise<any> {
+    const companyId = await this.getCompanyId();
+    const url = `${this.config.serverUrl}/companies(${companyId})/${resource}`;
+    return this.request('POST', url, data);
+  }
+
+  /**
+   * Update an existing item
+   */
+  async updateItem(resource: string, itemId: string, data: any): Promise<any> {
+    const companyId = await this.getCompanyId();
+    const url = `${this.config.serverUrl}/companies(${companyId})/${resource}(${itemId})`;
+    return this.request('PATCH', url, data);
+  }
+
+  /**
+   * Delete an item
+   */
+  async deleteItem(resource: string, itemId: string): Promise<void> {
+    const companyId = await this.getCompanyId();
+    const url = `${this.config.serverUrl}/companies(${companyId})/${resource}(${itemId})`;
+    await this.request('DELETE', url);
+  }
+}

package/src/index.ts

@@ -0,0 +1,303 @@
+#!/usr/bin/env node
+
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import {
+  CallToolRequestSchema,
+  ListToolsRequestSchema,
+} from '@modelcontextprotocol/sdk/types.js';
+import { BusinessCentralClient } from './business-central-client.js';
+
+// Read configuration from environment variables
+const BC_URL_SERVER = process.env.BC_URL_SERVER;
+const BC_COMPANY = process.env.BC_COMPANY;
+const BC_AUTH_TYPE = process.env.BC_AUTH_TYPE || 'azure_cli';
+
+if (!BC_URL_SERVER || !BC_COMPANY) {
+  console.error('Error: BC_URL_SERVER and BC_COMPANY environment variables are required');
+  process.exit(1);
+}
+
+if (BC_AUTH_TYPE !== 'azure_cli') {
+  console.error('Error: Only azure_cli authentication is currently supported');
+  process.exit(1);
+}
+
+// Create Business Central client
+const bcClient = new BusinessCentralClient({
+  serverUrl: BC_URL_SERVER,
+  companyName: BC_COMPANY,
+  authType: BC_AUTH_TYPE
+});
+
+// Create MCP server
+const server = new Server(
+  {
+    name: 'business-central',
+    version: '0.1.0',
+  },
+  {
+    capabilities: {
+      tools: {},
+    },
+  }
+);
+
+// Register tool handlers
+server.setRequestHandler(ListToolsRequestSchema, async () => {
+  return {
+    tools: [
+      {
+        name: 'get_schema',
+        description: 'Get schema information for a Business Central resource',
+        inputSchema: {
+          type: 'object',
+          properties: {
+            resource: {
+              type: 'string',
+              description: 'The resource name (e.g., customers, contacts, salesOpportunities)',
+            },
+          },
+          required: ['resource'],
+        },
+      },
+      {
+        name: 'list_items',
+        description: 'Get items from Business Central with filtering and pagination',
+        inputSchema: {
+          type: 'object',
+          properties: {
+            resource: {
+              type: 'string',
+              description: 'The resource name (e.g., customers, contacts, salesOpportunities)',
+            },
+            filter: {
+              type: 'string',
+              description: 'OData filter expression (optional)',
+            },
+            top: {
+              type: 'number',
+              description: 'Maximum number of items to return (optional)',
+            },
+            skip: {
+              type: 'number',
+              description: 'Number of items to skip for pagination (optional)',
+            },
+          },
+          required: ['resource'],
+        },
+      },
+      {
+        name: 'get_items_by_field',
+        description: 'Get items matching a field value',
+        inputSchema: {
+          type: 'object',
+          properties: {
+            resource: {
+              type: 'string',
+              description: 'The resource name (e.g., customers, contacts)',
+            },
+            field: {
+              type: 'string',
+              description: 'The field name to filter by',
+            },
+            value: {
+              type: 'string',
+              description: 'The value to match',
+            },
+          },
+          required: ['resource', 'field', 'value'],
+        },
+      },
+      {
+        name: 'create_item',
+        description: 'Create a new item in Business Central',
+        inputSchema: {
+          type: 'object',
+          properties: {
+            resource: {
+              type: 'string',
+              description: 'The resource name (e.g., customers, contacts)',
+            },
+            item_data: {
+              type: 'object',
+              description: 'The item data to create',
+            },
+          },
+          required: ['resource', 'item_data'],
+        },
+      },
+      {
+        name: 'update_item',
+        description: 'Update an existing item in Business Central',
+        inputSchema: {
+          type: 'object',
+          properties: {
+            resource: {
+              type: 'string',
+              description: 'The resource name (e.g., customers, contacts)',
+            },
+            item_id: {
+              type: 'string',
+              description: 'The ID of the item to update',
+            },
+            item_data: {
+              type: 'object',
+              description: 'The item data to update',
+            },
+          },
+          required: ['resource', 'item_id', 'item_data'],
+        },
+      },
+      {
+        name: 'delete_item',
+        description: 'Delete an item from Business Central',
+        inputSchema: {
+          type: 'object',
+          properties: {
+            resource: {
+              type: 'string',
+              description: 'The resource name (e.g., customers, contacts)',
+            },
+            item_id: {
+              type: 'string',
+              description: 'The ID of the item to delete',
+            },
+          },
+          required: ['resource', 'item_id'],
+        },
+      },
+    ],
+  };
+});
+
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+  try {
+    const { name, arguments: args } = request.params;
+
+    switch (name) {
+      case 'get_schema': {
+        const { resource } = args as { resource: string };
+        const result = await bcClient.getSchema(resource);
+        return {
+          content: [
+            {
+              type: 'text',
+              text: JSON.stringify(result, null, 2),
+            },
+          ],
+        };
+      }
+
+      case 'list_items': {
+        const { resource, filter, top, skip } = args as {
+          resource: string;
+          filter?: string;
+          top?: number;
+          skip?: number;
+        };
+        const result = await bcClient.listItems(resource, { filter, top, skip });
+        return {
+          content: [
+            {
+              type: 'text',
+              text: JSON.stringify(result, null, 2),
+            },
+          ],
+        };
+      }
+
+      case 'get_items_by_field': {
+        const { resource, field, value } = args as {
+          resource: string;
+          field: string;
+          value: string;
+        };
+        const result = await bcClient.getItemsByField(resource, field, value);
+        return {
+          content: [
+            {
+              type: 'text',
+              text: JSON.stringify(result, null, 2),
+            },
+          ],
+        };
+      }
+
+      case 'create_item': {
+        const { resource, item_data } = args as {
+          resource: string;
+          item_data: any;
+        };
+        const result = await bcClient.createItem(resource, item_data);
+        return {
+          content: [
+            {
+              type: 'text',
+              text: JSON.stringify(result, null, 2),
+            },
+          ],
+        };
+      }
+
+      case 'update_item': {
+        const { resource, item_id, item_data } = args as {
+          resource: string;
+          item_id: string;
+          item_data: any;
+        };
+        const result = await bcClient.updateItem(resource, item_id, item_data);
+        return {
+          content: [
+            {
+              type: 'text',
+              text: JSON.stringify(result, null, 2),
+            },
+          ],
+        };
+      }
+
+      case 'delete_item': {
+        const { resource, item_id } = args as {
+          resource: string;
+          item_id: string;
+        };
+        await bcClient.deleteItem(resource, item_id);
+        return {
+          content: [
+            {
+              type: 'text',
+              text: 'Item deleted successfully',
+            },
+          ],
+        };
+      }
+
+      default:
+        throw new Error(`Unknown tool: ${name}`);
+    }
+  } catch (error) {
+    const errorMessage = error instanceof Error ? error.message : String(error);
+    return {
+      content: [
+        {
+          type: 'text',
+          text: `Error: ${errorMessage}`,
+        },
+      ],
+      isError: true,
+    };
+  }
+});
+
+// Start server
+async function main() {
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+  console.error('Business Central MCP server running on stdio');
+}
+
+main().catch((error) => {
+  console.error('Server error:', error);
+  process.exit(1);
+});

package/tsconfig.json

@@ -0,0 +1,18 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ES2022",
+    "moduleResolution": "node",
+    "lib": ["ES2022"],
+    "outDir": "./build",
+    "rootDir": "./src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "resolveJsonModule": true,
+    "declaration": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "build"]
+}