@efficy/tribecrm-mcp-server 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Efficy SA
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,297 @@
+# TribeCRM MCP Server
+
+[![TypeScript](https://img.shields.io/badge/TypeScript-5.7-blue)](https://www.typescriptlang.org/)
+[![MCP SDK](https://img.shields.io/badge/MCP%20SDK-1.0-green)](https://github.com/modelcontextprotocol)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+Model Context Protocol (MCP) server for TribeCRM API integration. This server enables AI assistants like Claude to interact with TribeCRM entities, perform searches, and manage connectors.
+
+## 🚀 Features
+
+### Tools
+- **Entity Management** (CRUD operations)
+  - Create, read, update, and delete CRM entities
+  - Support for contacts, companies, deals, activities, and more
+- **Advanced Search & Query**
+  - Search across entities with filters and pagination
+  - Complex filter criteria support
+- **Connector Management**
+  - List available integration connectors
+  - Get connector details and status
+
+### Resources
+- **Entity Type Definitions**: Access schema and field information for entity types
+- **Dynamic Resources**: Entity data exposed as MCP resources for context
+
+## 📋 Prerequisites
+
+- Node.js 18 or higher
+- TribeCRM API credentials (Client ID and Secret)
+- Access to a TribeCRM instance
+
+## 🔧 Installation
+
+```bash
+npm install
+```
+
+## ⚙️ Configuration
+
+1. Copy the environment template:
+```bash
+cp .env.example .env
+```
+
+2. Configure your TribeCRM API credentials in `.env`:
+```env
+TRIBECRM_API_URL=https://api.tribecrm.com
+TRIBECRM_CLIENT_ID=your_client_id_here
+TRIBECRM_CLIENT_SECRET=your_client_secret_here
+TRIBECRM_ORGANIZATION_ID=optional_org_id
+MCP_SERVER_NAME=tribecrm
+```
+
+## 🏗️ Building
+
+```bash
+npm run build
+```
+
+## 🎯 Usage
+
+### Running the Server
+
+```bash
+npm start
+```
+
+### Development Mode
+
+```bash
+npm run dev
+```
+
+### MCP Client Configuration
+
+Add to your MCP client settings (e.g., `~/Library/Application Support/Claude/claude_desktop_config.json` for Claude Desktop):
+
+```json
+{
+  "mcpServers": {
+    "tribecrm": {
+      "command": "node",
+      "args": ["/absolute/path/to/tribecrm-mcp-server/dist/index.js"],
+      "env": {
+        "TRIBECRM_API_URL": "https://api.tribecrm.com",
+        "TRIBECRM_CLIENT_ID": "your_client_id",
+        "TRIBECRM_CLIENT_SECRET": "your_client_secret"
+      }
+    }
+  }
+}
+```
+
+## 📚 Available Tools
+
+### Entity Operations
+
+#### `tribecrm_get_entity`
+Retrieve a specific entity by ID
+
+**Parameters:**
+- `entityType` (string): Entity type (e.g., 'contact', 'company', 'deal')
+- `entityId` (string): Unique entity identifier
+
+**Example:**
+```json
+{
+  "entityType": "contact",
+  "entityId": "12345"
+}
+```
+
+#### `tribecrm_create_entity`
+Create a new entity
+
+**Parameters:**
+- `entityType` (string): Entity type to create
+- `data` (object): Entity data as key-value pairs
+
+**Example:**
+```json
+{
+  "entityType": "contact",
+  "data": {
+    "name": "John Smith",
+    "email": "john@example.com",
+    "phone": "+1234567890"
+  }
+}
+```
+
+#### `tribecrm_update_entity`
+Update an existing entity
+
+**Parameters:**
+- `entityType` (string): Entity type
+- `entityId` (string): Entity ID to update
+- `data` (object): Updated entity data
+
+**Example:**
+```json
+{
+  "entityType": "contact",
+  "entityId": "12345",
+  "data": {
+    "email": "newemail@example.com"
+  }
+}
+```
+
+#### `tribecrm_delete_entity`
+Delete an entity
+
+**Parameters:**
+- `entityType` (string): Entity type
+- `entityId` (string): Entity ID to delete
+
+### Search Operations
+
+#### `tribecrm_search_entities`
+Search for entities with filters and pagination
+
+**Parameters:**
+- `entityType` (string, required): Entity type to search
+- `query` (string, optional): Search query string
+- `filters` (object, optional): Filter criteria
+- `page` (number, optional): Page number (default: 1)
+- `pageSize` (number, optional): Results per page (default: 20, max: 100)
+
+**Example:**
+```json
+{
+  "entityType": "company",
+  "query": "tech",
+  "filters": {
+    "location": "New York",
+    "status": "active"
+  },
+  "page": 1,
+  "pageSize": 20
+}
+```
+
+### Connector Operations
+
+#### `tribecrm_list_connectors`
+List all available connectors
+
+**Parameters:** None
+
+#### `tribecrm_get_connector`
+Get details of a specific connector
+
+**Parameters:**
+- `connectorId` (string): Connector ID
+
+## 📖 Documentation
+
+- [Usage Examples](docs/EXAMPLES.md) - Detailed usage examples and scenarios
+- [Troubleshooting Guide](docs/TROUBLESHOOTING.md) - Common issues and solutions
+- [Contributing](CONTRIBUTING.md) - Guidelines for contributing to this project
+
+## 🏗️ Architecture
+
+```
+┌─────────────────┐
+│  MCP Client     │
+│  (Claude, etc.) │
+└────────┬────────┘
+         │
+         │ MCP Protocol (stdio)
+         │
+┌────────▼────────────────┐
+│  TribeCRM MCP Server    │
+│  ┌──────────────────┐   │
+│  │  Tool Handlers   │   │
+│  │  - Entity CRUD   │   │
+│  │  - Search        │   │
+│  │  - Connectors    │   │
+│  └──────────────────┘   │
+│  ┌──────────────────┐   │
+│  │ Resource Handler │   │
+│  │ - Entity Types   │   │
+│  └──────────────────┘   │
+│  ┌──────────────────┐   │
+│  │  API Client      │   │
+│  │  - OAuth2 Auth   │   │
+│  │  - HTTP Requests │   │
+│  └──────────────────┘   │
+└────────┬────────────────┘
+         │
+         │ HTTPS + OAuth2
+         │
+┌────────▼────────────┐
+│  TribeCRM API       │
+│  (REST API)         │
+└─────────────────────┘
+```
+
+## 🔐 Authentication
+
+The server uses OAuth2 Client Credentials flow:
+1. Authenticates with TribeCRM API using client credentials
+2. Obtains access token
+3. Automatically refreshes token before expiry
+4. Includes token in all API requests
+
+## 🛠️ Development
+
+### Project Structure
+
+```
+tribecrm-mcp-server/
+├── src/
+│   ├── index.ts          # Main MCP server implementation
+│   ├── client.ts         # TribeCRM API client
+│   └── types.ts          # TypeScript type definitions
+├── docs/
+│   ├── EXAMPLES.md       # Usage examples
+│   └── TROUBLESHOOTING.md # Troubleshooting guide
+├── dist/                 # Compiled JavaScript (generated)
+├── .env.example          # Environment template
+├── package.json          # Dependencies and scripts
+├── tsconfig.json         # TypeScript configuration
+└── README.md            # This file
+```
+
+### Tech Stack
+
+- **TypeScript** - Type-safe development
+- **@modelcontextprotocol/sdk** - MCP protocol implementation
+- **axios** - HTTP client for API requests
+- **dotenv** - Environment variable management
+
+## 🤝 Contributing
+
+Contributions are welcome! Please see [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
+
+## 📝 License
+
+MIT License - see LICENSE file for details
+
+## 🔗 Links
+
+- [TribeCRM](https://tribecrm.com) - Official TribeCRM website
+- [Model Context Protocol](https://modelcontextprotocol.io) - MCP documentation
+- [GitHub Repository](https://github.com/jnorsa-efficy/tribecrm-mcp-server)
+
+## 📧 Support
+
+For issues and questions:
+- Open an issue on [GitHub](https://github.com/jnorsa-efficy/tribecrm-mcp-server/issues)
+- Check the [Troubleshooting Guide](docs/TROUBLESHOOTING.md)
+
+---
+
+**Note:** This is an unofficial MCP server for TribeCRM. For official API documentation, please refer to your TribeCRM instance documentation.

package/dist/client.d.ts

@@ -0,0 +1,59 @@
+import { TribeCRMConfig, Entity, EntityType } from './types.js';
+export declare class TribeCRMClient {
+    private axiosInstance;
+    private config;
+    private token;
+    private tokenExpiry;
+    constructor(config: TribeCRMConfig);
+    private ensureAuthenticated;
+    /**
+     * Get a single entity by ID
+     * @param entityType OData entity type (e.g. 'Relation_Organization', 'Relation_Person')
+     * @param entityId Entity UUID
+     * @param expand Optional $expand parameter
+     * @param select Optional $select parameter
+     */
+    getEntity(entityType: string, entityId: string, expand?: string, select?: string): Promise<Entity>;
+    /**
+     * Create a new entity
+     * @param entityType OData entity type
+     * @param data Entity data (without ID)
+     */
+    createEntity(entityType: string, data: Record<string, any>): Promise<Entity>;
+    /**
+     * Update an existing entity
+     * @param entityType OData entity type
+     * @param entityId Entity UUID
+     * @param data Entity data (must include ID)
+     */
+    updateEntity(entityType: string, entityId: string, data: Record<string, any>): Promise<Entity>;
+    /**
+     * Delete an entity
+     * @param entityType OData entity type
+     * @param entityId Entity UUID
+     */
+    deleteEntity(entityType: string, entityId: string): Promise<void>;
+    /**
+     * Search/query entities with OData filters
+     * @param entityType OData entity type
+     * @param options Query options (filter, select, expand, orderby, top, skip, count)
+     */
+    queryEntities(entityType: string, options?: {
+        filter?: string;
+        select?: string;
+        expand?: string;
+        orderby?: string;
+        top?: number;
+        skip?: number;
+        count?: boolean;
+    }): Promise<any>;
+    /**
+     * Get current employee information
+     */
+    getCurrentEmployee(expand?: string): Promise<any>;
+    /**
+     * List available entity types (metadata)
+     */
+    listEntityTypes(): Promise<EntityType[]>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAa,MAAM,EAAE,UAAU,EAA2B,MAAM,YAAY,CAAC;AAEpG,qBAAa,cAAc;IACzB,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,KAAK,CAA0B;IACvC,OAAO,CAAC,WAAW,CAAa;gBAEpB,MAAM,EAAE,cAAc;YAUpB,mBAAmB;IA+BjC;;;;;;OAMG;IACG,SAAS,CACb,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,MAAM,CAAC;IAUlB;;;;OAIG;IACG,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;IAMlF;;;;;OAKG;IACG,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;IAOpG;;;;OAIG;IACG,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKvE;;;;OAIG;IACG,aAAa,CACjB,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE;QACR,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,KAAK,CAAC,EAAE,OAAO,CAAC;KACjB,GACA,OAAO,CAAC,GAAG,CAAC;IAgBf;;OAEG;IACG,kBAAkB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;IASvD;;OAEG;IACG,eAAe,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;CAoB/C"}

package/dist/client.js

@@ -0,0 +1,150 @@
+import axios from 'axios';
+export class TribeCRMClient {
+    axiosInstance;
+    config;
+    token = null;
+    tokenExpiry = 0;
+    constructor(config) {
+        this.config = config;
+        this.axiosInstance = axios.create({
+            baseURL: config.apiUrl,
+            headers: {
+                'Content-Type': 'application/json',
+            },
+        });
+    }
+    async ensureAuthenticated() {
+        const now = Date.now();
+        if (this.token && this.tokenExpiry > now + 60000) {
+            return;
+        }
+        try {
+            const response = await axios.post('https://auth.tribecrm.nl/oauth2/token', new URLSearchParams({
+                grant_type: 'client_credentials',
+                client_id: this.config.clientId,
+                client_secret: this.config.clientSecret,
+                scope: 'read write offline',
+                ...(this.config.organizationId && { organization_id: this.config.organizationId }),
+            }), {
+                headers: {
+                    'Content-Type': 'application/x-www-form-urlencoded',
+                },
+            });
+            this.token = response.data;
+            this.tokenExpiry = now + (this.token.expires_in * 1000);
+            this.axiosInstance.defaults.headers.common['Authorization'] = `Bearer ${this.token.access_token}`;
+        }
+        catch (error) {
+            throw new Error(`Authentication failed: ${error.response?.data?.error_description || error.message}`);
+        }
+    }
+    /**
+     * Get a single entity by ID
+     * @param entityType OData entity type (e.g. 'Relation_Organization', 'Relation_Person')
+     * @param entityId Entity UUID
+     * @param expand Optional $expand parameter
+     * @param select Optional $select parameter
+     */
+    async getEntity(entityType, entityId, expand, select) {
+        await this.ensureAuthenticated();
+        const params = {};
+        if (expand)
+            params.$expand = expand;
+        if (select)
+            params.$select = select;
+        const response = await this.axiosInstance.get(`/v1/odata/${entityType}(${entityId})`, { params });
+        return response.data;
+    }
+    /**
+     * Create a new entity
+     * @param entityType OData entity type
+     * @param data Entity data (without ID)
+     */
+    async createEntity(entityType, data) {
+        await this.ensureAuthenticated();
+        const response = await this.axiosInstance.post(`/v1/odata/${entityType}`, data);
+        return response.data;
+    }
+    /**
+     * Update an existing entity
+     * @param entityType OData entity type
+     * @param entityId Entity UUID
+     * @param data Entity data (must include ID)
+     */
+    async updateEntity(entityType, entityId, data) {
+        await this.ensureAuthenticated();
+        const payload = { ...data, ID: entityId };
+        const response = await this.axiosInstance.post(`/v1/odata/${entityType}`, payload);
+        return response.data;
+    }
+    /**
+     * Delete an entity
+     * @param entityType OData entity type
+     * @param entityId Entity UUID
+     */
+    async deleteEntity(entityType, entityId) {
+        await this.ensureAuthenticated();
+        await this.axiosInstance.delete(`/v1/odata/${entityType}(${entityId})`);
+    }
+    /**
+     * Search/query entities with OData filters
+     * @param entityType OData entity type
+     * @param options Query options (filter, select, expand, orderby, top, skip, count)
+     */
+    async queryEntities(entityType, options) {
+        await this.ensureAuthenticated();
+        const params = {};
+        if (options?.filter)
+            params.$filter = options.filter;
+        if (options?.select)
+            params.$select = options.select;
+        if (options?.expand)
+            params.$expand = options.expand;
+        if (options?.orderby)
+            params.$orderby = options.orderby;
+        if (options?.top)
+            params.$top = options.top;
+        if (options?.skip)
+            params.$skip = options.skip;
+        if (options?.count)
+            params.$count = 'true';
+        const response = await this.axiosInstance.get(`/v1/odata/${entityType}`, { params });
+        return response.data;
+    }
+    /**
+     * Get current employee information
+     */
+    async getCurrentEmployee(expand) {
+        await this.ensureAuthenticated();
+        const params = {};
+        if (expand)
+            params.$expand = expand;
+        const response = await this.axiosInstance.get('/v1/odata/GetCurrentEmployee()', { params });
+        return response.data;
+    }
+    /**
+     * List available entity types (metadata)
+     */
+    async listEntityTypes() {
+        await this.ensureAuthenticated();
+        try {
+            const response = await this.axiosInstance.get('/v1/odata/$metadata');
+            // Parse OData metadata XML - simplified version
+            // In production, you'd parse the XML properly
+            return [
+                { code: 'Relation_Organization', name: 'Organizations', fields: [] },
+                { code: 'Relation_Person', name: 'Persons', fields: [] },
+                { code: 'Relationship_Organization_CommercialRelationship_Customer', name: 'Customers', fields: [] },
+                { code: 'Relationship_Organization_CommercialRelationship_Lead', name: 'Leads', fields: [] },
+                { code: 'Activity_Invoice', name: 'Invoices', fields: [] },
+                { code: 'Activity_Appointment', name: 'Appointments', fields: [] },
+                { code: 'Product', name: 'Products', fields: [] },
+            ];
+        }
+        catch (error) {
+            console.error('Error fetching metadata:', error);
+            return [];
+        }
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,336 @@
+#!/usr/bin/env node
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { CallToolRequestSchema, ListResourcesRequestSchema, ListToolsRequestSchema, ReadResourceRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
+import dotenv from 'dotenv';
+import { TribeCRMClient } from './client.js';
+// Load environment variables
+dotenv.config();
+// Validate configuration
+const config = {
+    apiUrl: process.env.TRIBECRM_API_URL || 'https://api.tribecrm.nl',
+    clientId: process.env.TRIBECRM_CLIENT_ID || '',
+    clientSecret: process.env.TRIBECRM_CLIENT_SECRET || '',
+    organizationId: process.env.TRIBECRM_ORGANIZATION_ID,
+};
+if (!config.clientId || !config.clientSecret) {
+    console.error('Error: Missing required environment variables');
+    console.error('Required: TRIBECRM_CLIENT_ID, TRIBECRM_CLIENT_SECRET');
+    console.error('Optional: TRIBECRM_API_URL (default: https://api.tribecrm.nl), TRIBECRM_ORGANIZATION_ID');
+    process.exit(1);
+}
+// Initialize client
+const client = new TribeCRMClient(config);
+// Initialize MCP server
+const server = new Server({
+    name: process.env.MCP_SERVER_NAME || 'tribecrm',
+    version: '0.2.0',
+}, {
+    capabilities: {
+        tools: {},
+        resources: {},
+    },
+});
+// Register tool handlers
+server.setRequestHandler(ListToolsRequestSchema, async () => {
+    return {
+        tools: [
+            {
+                name: 'tribecrm_get_entity',
+                description: 'Get a single entity by ID. Common entity types: Relation_Organization, Relation_Person, Activity_Invoice, Product',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        entityType: {
+                            type: 'string',
+                            description: 'OData entity type (e.g., Relation_Organization, Relation_Person, Activity_Invoice)',
+                        },
+                        entityId: {
+                            type: 'string',
+                            description: 'Entity UUID',
+                        },
+                        expand: {
+                            type: 'string',
+                            description: 'Optional $expand parameter (e.g., "Address", "InvoiceAddress($expand=Country)")',
+                        },
+                        select: {
+                            type: 'string',
+                            description: 'Optional $select parameter (e.g., "Name,EmailAddress,PhoneNumber")',
+                        },
+                    },
+                    required: ['entityType', 'entityId'],
+                },
+            },
+            {
+                name: 'tribecrm_query_entities',
+                description: 'Query entities with OData filters. Supports $filter, $select, $expand, $orderby, $top, $skip, $count',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        entityType: {
+                            type: 'string',
+                            description: 'OData entity type to query',
+                        },
+                        filter: {
+                            type: 'string',
+                            description: 'OData $filter expression (e.g., "Name eq \'John\' or contains(Name,\'tech\')")',
+                        },
+                        select: {
+                            type: 'string',
+                            description: 'Comma-separated list of fields to return',
+                        },
+                        expand: {
+                            type: 'string',
+                            description: 'Related entities to expand',
+                        },
+                        orderby: {
+                            type: 'string',
+                            description: 'Field to sort by with optional desc (e.g., "Name desc")',
+                        },
+                        top: {
+                            type: 'number',
+                            description: 'Number of records to return (pagination)',
+                        },
+                        skip: {
+                            type: 'number',
+                            description: 'Number of records to skip (pagination)',
+                        },
+                        count: {
+                            type: 'boolean',
+                            description: 'Include total count in response',
+                        },
+                    },
+                    required: ['entityType'],
+                },
+            },
+            {
+                name: 'tribecrm_create_entity',
+                description: 'Create a new entity in TribeCRM',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        entityType: {
+                            type: 'string',
+                            description: 'OData entity type',
+                        },
+                        data: {
+                            type: 'object',
+                            description: 'Entity data (do not include ID)',
+                        },
+                    },
+                    required: ['entityType', 'data'],
+                },
+            },
+            {
+                name: 'tribecrm_update_entity',
+                description: 'Update an existing entity in TribeCRM',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        entityType: {
+                            type: 'string',
+                            description: 'OData entity type',
+                        },
+                        entityId: {
+                            type: 'string',
+                            description: 'Entity UUID to update',
+                        },
+                        data: {
+                            type: 'object',
+                            description: 'Updated entity data',
+                        },
+                    },
+                    required: ['entityType', 'entityId', 'data'],
+                },
+            },
+            {
+                name: 'tribecrm_delete_entity',
+                description: 'Delete an entity from TribeCRM',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        entityType: {
+                            type: 'string',
+                            description: 'OData entity type',
+                        },
+                        entityId: {
+                            type: 'string',
+                            description: 'Entity UUID to delete',
+                        },
+                    },
+                    required: ['entityType', 'entityId'],
+                },
+            },
+            {
+                name: 'tribecrm_get_current_employee',
+                description: 'Get information about the currently authenticated employee',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        expand: {
+                            type: 'string',
+                            description: 'Optional $expand parameter (e.g., "Person")',
+                        },
+                    },
+                },
+            },
+        ],
+    };
+});
+// Register call tool handler
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    try {
+        const { name, arguments: args } = request.params;
+        switch (name) {
+            case 'tribecrm_get_entity': {
+                const { entityType, entityId, expand, select } = args;
+                const entity = await client.getEntity(entityType, entityId, expand, select);
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify(entity, null, 2),
+                        },
+                    ],
+                };
+            }
+            case 'tribecrm_query_entities': {
+                const { entityType, filter, select, expand, orderby, top, skip, count } = args;
+                const results = await client.queryEntities(entityType, {
+                    filter,
+                    select,
+                    expand,
+                    orderby,
+                    top,
+                    skip,
+                    count,
+                });
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify(results, null, 2),
+                        },
+                    ],
+                };
+            }
+            case 'tribecrm_create_entity': {
+                const { entityType, data } = args;
+                const entity = await client.createEntity(entityType, data);
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `Entity created successfully:\\n${JSON.stringify(entity, null, 2)}`,
+                        },
+                    ],
+                };
+            }
+            case 'tribecrm_update_entity': {
+                const { entityType, entityId, data } = args;
+                const entity = await client.updateEntity(entityType, entityId, data);
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `Entity updated successfully:\\n${JSON.stringify(entity, null, 2)}`,
+                        },
+                    ],
+                };
+            }
+            case 'tribecrm_delete_entity': {
+                const { entityType, entityId } = args;
+                await client.deleteEntity(entityType, entityId);
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `Entity ${entityId} deleted successfully`,
+                        },
+                    ],
+                };
+            }
+            case 'tribecrm_get_current_employee': {
+                const { expand } = args;
+                const employee = await client.getCurrentEmployee(expand);
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify(employee, null, 2),
+                        },
+                    ],
+                };
+            }
+            default:
+                throw new Error(`Unknown tool: ${name}`);
+        }
+    }
+    catch (error) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Error: ${error.response?.data?.error?.message || error.message}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+});
+// Register resource handlers
+server.setRequestHandler(ListResourcesRequestSchema, async () => {
+    try {
+        const entityTypes = await client.listEntityTypes();
+        return {
+            resources: entityTypes.map((type) => ({
+                uri: `tribecrm://entity-types/${type.code}`,
+                name: type.name,
+                description: `Entity type: ${type.name}`,
+                mimeType: 'application/json',
+            })),
+        };
+    }
+    catch (error) {
+        console.error('Error listing resources:', error);
+        return { resources: [] };
+    }
+});
+server.setRequestHandler(ReadResourceRequestSchema, async (request) => {
+    const { uri } = request.params;
+    try {
+        if (uri.startsWith('tribecrm://entity-types/')) {
+            const entityTypeCode = uri.replace('tribecrm://entity-types/', '');
+            const entityTypes = await client.listEntityTypes();
+            const entityType = entityTypes.find((t) => t.code === entityTypeCode);
+            if (!entityType) {
+                throw new Error(`Entity type not found: ${entityTypeCode}`);
+            }
+            return {
+                contents: [
+                    {
+                        uri,
+                        mimeType: 'application/json',
+                        text: JSON.stringify(entityType, null, 2),
+                    },
+                ],
+            };
+        }
+        throw new Error(`Unknown resource URI: ${uri}`);
+    }
+    catch (error) {
+        throw new Error(`Error reading resource: ${error.message}`);
+    }
+});
+// Start server
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error('TribeCRM MCP Server v0.2.0 running on stdio');
+    console.error('Connected to:', config.apiUrl);
+}
+main().catch((error) => {
+    console.error('Server error:', error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,42 @@
+export interface TribeCRMConfig {
+    apiUrl: string;
+    clientId: string;
+    clientSecret: string;
+    organizationId?: string;
+}
+export interface AuthToken {
+    access_token: string;
+    token_type: string;
+    expires_in: number;
+    scope: string;
+}
+export interface Entity {
+    id: string;
+    type: string;
+    [key: string]: any;
+}
+export interface EntityType {
+    code: string;
+    name: string;
+    fields: EntityField[];
+}
+export interface EntityField {
+    code: string;
+    name: string;
+    type: string;
+    required: boolean;
+}
+export interface SearchResult {
+    items: Entity[];
+    totalCount: number;
+    page: number;
+    pageSize: number;
+}
+export interface Connector {
+    id: string;
+    code: string;
+    name: string;
+    type: string;
+    enabled: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,SAAS;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,MAAM;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,WAAW,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;CAClB"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "@efficy/tribecrm-mcp-server",
+  "version": "0.2.0",
+  "description": "Model Context Protocol server for TribeCRM API - enables AI assistants to interact with TribeCRM",
+  "main": "dist/index.js",
+  "type": "module",
+  "bin": {
+    "tribecrm-mcp-server": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "start": "node dist/index.js",
+    "prepare": "npm run build",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "tribecrm",
+    "api",
+    "crm",
+    "odata",
+    "claude",
+    "ai",
+    "llm"
+  ],
+  "author": "Johann Norsa <johann.norsa@efficy.com>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/efficy-sa/tribecrm-mcp-server.git"
+  },
+  "bugs": {
+    "url": "https://github.com/efficy-sa/tribecrm-mcp-server/issues"
+  },
+  "homepage": "https://github.com/efficy-sa/tribecrm-mcp-server#readme",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.4",
+    "axios": "^1.7.9",
+    "dotenv": "^16.4.7"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.5",
+    "typescript": "^5.7.3"
+  }
+}