@epicai/legion 1.0.0

package/dist/mcp-servers/aircall.js

@@ -0,0 +1,896 @@
+/**
+ * Aircall MCP Adapter
+ * Built on the Epic AI® Intelligence Platform
+ * Copyright 2026 protectNIL Inc. Apache-2.0
+ */
+import { MCPAdapterBase } from './base.js';
+export class AircallMCPServer extends MCPAdapterBase {
+    apiId;
+    apiToken;
+    baseUrl;
+    constructor(config) {
+        super();
+        this.apiId = config.apiId;
+        this.apiToken = config.apiToken;
+        this.baseUrl = config.baseUrl || 'https://api.aircall.io/v1';
+    }
+    static catalog() {
+        return {
+            name: 'aircall',
+            displayName: 'Aircall',
+            version: '1.0.0',
+            category: 'communication',
+            keywords: [
+                'aircall', 'phone', 'call', 'voip', 'cloud phone', 'sales calls',
+                'support calls', 'call center', 'transcript', 'recording', 'ivr',
+                'contact', 'user', 'team', 'number', 'webhook', 'tag',
+            ],
+            toolNames: [
+                'list_calls', 'get_call', 'search_calls', 'add_call_tags', 'transfer_call',
+                'list_users', 'get_user', 'create_user', 'update_user', 'delete_user',
+                'list_numbers', 'get_number', 'update_number',
+                'list_teams', 'get_team', 'create_team', 'delete_team', 'add_user_to_team', 'remove_user_from_team',
+                'list_contacts', 'get_contact', 'create_contact', 'update_contact', 'delete_contact',
+                'list_webhooks', 'create_webhook', 'update_webhook', 'delete_webhook',
+                'list_tags', 'create_tag',
+            ],
+            description: 'Aircall cloud phone system: manage calls, recordings, transcripts, users, numbers, teams, contacts, webhooks, and tags.',
+            author: 'protectnil',
+        };
+    }
+    get tools() {
+        return [
+            // ── Calls ──────────────────────────────────────────────────────────────
+            {
+                name: 'list_calls',
+                description: 'List call logs with optional filters for direction, user, number, date range, and pagination',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        direction: {
+                            type: 'string',
+                            description: 'Filter by call direction: inbound or outbound',
+                        },
+                        user_id: {
+                            type: 'number',
+                            description: 'Filter calls by the Aircall user ID who handled the call',
+                        },
+                        number_id: {
+                            type: 'number',
+                            description: 'Filter calls by the Aircall phone number ID',
+                        },
+                        from: {
+                            type: 'number',
+                            description: 'Unix timestamp — return calls started after this time',
+                        },
+                        to: {
+                            type: 'number',
+                            description: 'Unix timestamp — return calls started before this time',
+                        },
+                        order: {
+                            type: 'string',
+                            description: 'Sort order: asc or desc by started_at (default: desc)',
+                        },
+                        per_page: {
+                            type: 'number',
+                            description: 'Results per page (max: 50, default: 20)',
+                        },
+                        page: {
+                            type: 'number',
+                            description: 'Page number for pagination (default: 1)',
+                        },
+                    },
+                },
+            },
+            {
+                name: 'get_call',
+                description: 'Get full details for a single call by ID, including recording URL, transcript, tags, and participants',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        call_id: {
+                            type: 'number',
+                            description: 'Aircall call ID to retrieve',
+                        },
+                    },
+                    required: ['call_id'],
+                },
+            },
+            {
+                name: 'search_calls',
+                description: 'Search call logs by phone number, contact name, or tag with optional date range filters',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        query: {
+                            type: 'string',
+                            description: 'Search term: phone number (e.g. +14155552671), contact name, or tag name',
+                        },
+                        from: {
+                            type: 'number',
+                            description: 'Unix timestamp — search calls after this time',
+                        },
+                        to: {
+                            type: 'number',
+                            description: 'Unix timestamp — search calls before this time',
+                        },
+                        per_page: {
+                            type: 'number',
+                            description: 'Results per page (max: 50, default: 20)',
+                        },
+                    },
+                    required: ['query'],
+                },
+            },
+            {
+                name: 'add_call_tags',
+                description: 'Add one or more tags to a completed call by call ID',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        call_id: {
+                            type: 'number',
+                            description: 'Aircall call ID to tag',
+                        },
+                        tag_ids: {
+                            type: 'array',
+                            description: 'Array of tag IDs to apply to the call',
+                            items: { type: 'number' },
+                        },
+                    },
+                    required: ['call_id', 'tag_ids'],
+                },
+            },
+            {
+                name: 'transfer_call',
+                description: 'Transfer an active call to another user or number by call ID',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        call_id: {
+                            type: 'number',
+                            description: 'Aircall call ID of the active call to transfer',
+                        },
+                        user_id: {
+                            type: 'number',
+                            description: 'Destination user ID to transfer the call to',
+                        },
+                    },
+                    required: ['call_id', 'user_id'],
+                },
+            },
+            // ── Users ──────────────────────────────────────────────────────────────
+            {
+                name: 'list_users',
+                description: 'List all users in the Aircall account with their roles, availability, and assigned numbers',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        per_page: {
+                            type: 'number',
+                            description: 'Results per page (max: 50, default: 20)',
+                        },
+                        page: {
+                            type: 'number',
+                            description: 'Page number for pagination (default: 1)',
+                        },
+                    },
+                },
+            },
+            {
+                name: 'get_user',
+                description: 'Get details for a single Aircall user by user ID, including role, availability, and phone numbers',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        user_id: {
+                            type: 'number',
+                            description: 'Aircall user ID to retrieve',
+                        },
+                    },
+                    required: ['user_id'],
+                },
+            },
+            {
+                name: 'create_user',
+                description: 'Invite a new user to the Aircall account by email with optional role assignment',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        email: {
+                            type: 'string',
+                            description: 'Email address of the user to invite',
+                        },
+                        first_name: {
+                            type: 'string',
+                            description: 'First name of the new user',
+                        },
+                        last_name: {
+                            type: 'string',
+                            description: 'Last name of the new user',
+                        },
+                        role: {
+                            type: 'string',
+                            description: 'User role: admin or agent (default: agent)',
+                        },
+                    },
+                    required: ['email', 'first_name', 'last_name'],
+                },
+            },
+            {
+                name: 'update_user',
+                description: 'Update an existing Aircall user profile — name, role, time zone, or availability state',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        user_id: {
+                            type: 'number',
+                            description: 'Aircall user ID to update',
+                        },
+                        first_name: {
+                            type: 'string',
+                            description: 'Updated first name',
+                        },
+                        last_name: {
+                            type: 'string',
+                            description: 'Updated last name',
+                        },
+                        role: {
+                            type: 'string',
+                            description: 'Updated role: admin or agent',
+                        },
+                        time_zone: {
+                            type: 'string',
+                            description: 'IANA time zone (e.g. America/New_York)',
+                        },
+                        availability: {
+                            type: 'string',
+                            description: 'Availability state: available or unavailable',
+                        },
+                    },
+                    required: ['user_id'],
+                },
+            },
+            {
+                name: 'delete_user',
+                description: 'Remove a user from the Aircall account by user ID',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        user_id: {
+                            type: 'number',
+                            description: 'Aircall user ID to delete',
+                        },
+                    },
+                    required: ['user_id'],
+                },
+            },
+            // ── Numbers ────────────────────────────────────────────────────────────
+            {
+                name: 'list_numbers',
+                description: 'List all phone numbers in the Aircall account with their assigned users and IVR configuration',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        per_page: {
+                            type: 'number',
+                            description: 'Results per page (max: 50, default: 20)',
+                        },
+                        page: {
+                            type: 'number',
+                            description: 'Page number for pagination (default: 1)',
+                        },
+                    },
+                },
+            },
+            {
+                name: 'get_number',
+                description: 'Get configuration details for a specific Aircall phone number by number ID',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        number_id: {
+                            type: 'number',
+                            description: 'Aircall number ID to retrieve',
+                        },
+                    },
+                    required: ['number_id'],
+                },
+            },
+            {
+                name: 'update_number',
+                description: 'Update the name, business hours, or IVR settings for an Aircall phone number',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        number_id: {
+                            type: 'number',
+                            description: 'Aircall number ID to update',
+                        },
+                        name: {
+                            type: 'string',
+                            description: 'Display name for the phone number',
+                        },
+                        open: {
+                            type: 'boolean',
+                            description: 'Whether the number is open for calls (business hours override)',
+                        },
+                    },
+                    required: ['number_id'],
+                },
+            },
+            // ── Teams ──────────────────────────────────────────────────────────────
+            {
+                name: 'list_teams',
+                description: 'List all teams in the Aircall account with their member counts and assigned numbers',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        per_page: {
+                            type: 'number',
+                            description: 'Results per page (max: 50, default: 20)',
+                        },
+                        page: {
+                            type: 'number',
+                            description: 'Page number for pagination (default: 1)',
+                        },
+                    },
+                },
+            },
+            {
+                name: 'get_team',
+                description: 'Get details for a single Aircall team by team ID, including member list and assigned numbers',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        team_id: {
+                            type: 'number',
+                            description: 'Aircall team ID to retrieve',
+                        },
+                    },
+                    required: ['team_id'],
+                },
+            },
+            {
+                name: 'create_team',
+                description: 'Create a new team in the Aircall account with an optional name',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        name: {
+                            type: 'string',
+                            description: 'Display name for the new team',
+                        },
+                    },
+                    required: ['name'],
+                },
+            },
+            {
+                name: 'delete_team',
+                description: 'Delete an Aircall team by team ID (members are not deleted, only removed from the team)',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        team_id: {
+                            type: 'number',
+                            description: 'Aircall team ID to delete',
+                        },
+                    },
+                    required: ['team_id'],
+                },
+            },
+            {
+                name: 'add_user_to_team',
+                description: 'Add a user to an Aircall team by team ID and user ID',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        team_id: {
+                            type: 'number',
+                            description: 'Aircall team ID to add the user to',
+                        },
+                        user_id: {
+                            type: 'number',
+                            description: 'Aircall user ID to add to the team',
+                        },
+                    },
+                    required: ['team_id', 'user_id'],
+                },
+            },
+            {
+                name: 'remove_user_from_team',
+                description: 'Remove a user from an Aircall team by team ID and user ID',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        team_id: {
+                            type: 'number',
+                            description: 'Aircall team ID to remove the user from',
+                        },
+                        user_id: {
+                            type: 'number',
+                            description: 'Aircall user ID to remove from the team',
+                        },
+                    },
+                    required: ['team_id', 'user_id'],
+                },
+            },
+            // ── Contacts ───────────────────────────────────────────────────────────
+            {
+                name: 'list_contacts',
+                description: 'List all contacts in the Aircall phonebook with optional search and pagination',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        per_page: {
+                            type: 'number',
+                            description: 'Results per page (max: 50, default: 20)',
+                        },
+                        page: {
+                            type: 'number',
+                            description: 'Page number for pagination (default: 1)',
+                        },
+                    },
+                },
+            },
+            {
+                name: 'get_contact',
+                description: 'Get a single Aircall contact by contact ID, including phone numbers and linked calls',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        contact_id: {
+                            type: 'number',
+                            description: 'Aircall contact ID to retrieve',
+                        },
+                    },
+                    required: ['contact_id'],
+                },
+            },
+            {
+                name: 'create_contact',
+                description: 'Create a new contact in the Aircall phonebook with name and phone number',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        first_name: {
+                            type: 'string',
+                            description: 'Contact first name',
+                        },
+                        last_name: {
+                            type: 'string',
+                            description: 'Contact last name',
+                        },
+                        information: {
+                            type: 'array',
+                            description: 'Array of contact info objects, each with label (phone_number, email) and value',
+                            items: { type: 'object' },
+                        },
+                    },
+                    required: ['first_name'],
+                },
+            },
+            {
+                name: 'update_contact',
+                description: 'Update an existing Aircall contact name or phone numbers by contact ID',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        contact_id: {
+                            type: 'number',
+                            description: 'Aircall contact ID to update',
+                        },
+                        first_name: {
+                            type: 'string',
+                            description: 'Updated first name',
+                        },
+                        last_name: {
+                            type: 'string',
+                            description: 'Updated last name',
+                        },
+                        information: {
+                            type: 'array',
+                            description: 'Updated array of contact info objects with label and value',
+                            items: { type: 'object' },
+                        },
+                    },
+                    required: ['contact_id'],
+                },
+            },
+            {
+                name: 'delete_contact',
+                description: 'Delete a contact from the Aircall phonebook by contact ID',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        contact_id: {
+                            type: 'number',
+                            description: 'Aircall contact ID to delete',
+                        },
+                    },
+                    required: ['contact_id'],
+                },
+            },
+            // ── Webhooks ───────────────────────────────────────────────────────────
+            {
+                name: 'list_webhooks',
+                description: 'List all registered webhooks for the Aircall account with their event subscriptions and URLs',
+                inputSchema: {
+                    type: 'object',
+                    properties: {},
+                },
+            },
+            {
+                name: 'create_webhook',
+                description: 'Register a new webhook URL for Aircall call events (call.created, call.answered, call.ended, etc.)',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        label: {
+                            type: 'string',
+                            description: 'Display label for the webhook',
+                        },
+                        url: {
+                            type: 'string',
+                            description: 'HTTPS URL that will receive POST payloads for subscribed events',
+                        },
+                        custom_headers: {
+                            type: 'object',
+                            description: 'Optional custom HTTP headers to include with each webhook delivery',
+                        },
+                    },
+                    required: ['url'],
+                },
+            },
+            {
+                name: 'update_webhook',
+                description: 'Update the URL, label, or custom headers of an existing Aircall webhook by webhook ID',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        webhook_id: {
+                            type: 'number',
+                            description: 'Aircall webhook ID to update',
+                        },
+                        label: {
+                            type: 'string',
+                            description: 'New display label for the webhook',
+                        },
+                        url: {
+                            type: 'string',
+                            description: 'New HTTPS URL for the webhook',
+                        },
+                    },
+                    required: ['webhook_id'],
+                },
+            },
+            {
+                name: 'delete_webhook',
+                description: 'Delete a registered webhook from the Aircall account by webhook ID',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        webhook_id: {
+                            type: 'number',
+                            description: 'Aircall webhook ID to delete',
+                        },
+                    },
+                    required: ['webhook_id'],
+                },
+            },
+            // ── Tags ───────────────────────────────────────────────────────────────
+            {
+                name: 'list_tags',
+                description: 'List all call tags defined in the Aircall account with their IDs and colors',
+                inputSchema: {
+                    type: 'object',
+                    properties: {},
+                },
+            },
+            {
+                name: 'create_tag',
+                description: 'Create a new call tag in the Aircall account with a name and optional color',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        name: {
+                            type: 'string',
+                            description: 'Display name for the tag (e.g. "follow-up", "VIP", "bug-report")',
+                        },
+                        color: {
+                            type: 'string',
+                            description: 'Hex color code for the tag (e.g. #FF5733)',
+                        },
+                    },
+                    required: ['name'],
+                },
+            },
+        ];
+    }
+    async callTool(name, args) {
+        try {
+            switch (name) {
+                case 'list_calls': return this.listCalls(args);
+                case 'get_call': return this.getCall(args);
+                case 'search_calls': return this.searchCalls(args);
+                case 'add_call_tags': return this.addCallTags(args);
+                case 'transfer_call': return this.transferCall(args);
+                case 'list_users': return this.listUsers(args);
+                case 'get_user': return this.getUser(args);
+                case 'create_user': return this.createUser(args);
+                case 'update_user': return this.updateUser(args);
+                case 'delete_user': return this.deleteUser(args);
+                case 'list_numbers': return this.listNumbers(args);
+                case 'get_number': return this.getNumber(args);
+                case 'update_number': return this.updateNumber(args);
+                case 'list_teams': return this.listTeams(args);
+                case 'get_team': return this.getTeam(args);
+                case 'create_team': return this.createTeam(args);
+                case 'delete_team': return this.deleteTeam(args);
+                case 'add_user_to_team': return this.addUserToTeam(args);
+                case 'remove_user_from_team': return this.removeUserFromTeam(args);
+                case 'list_contacts': return this.listContacts(args);
+                case 'get_contact': return this.getContact(args);
+                case 'create_contact': return this.createContact(args);
+                case 'update_contact': return this.updateContact(args);
+                case 'delete_contact': return this.deleteContact(args);
+                case 'list_webhooks': return this.listWebhooks();
+                case 'create_webhook': return this.createWebhook(args);
+                case 'update_webhook': return this.updateWebhook(args);
+                case 'delete_webhook': return this.deleteWebhook(args);
+                case 'list_tags': return this.listTags();
+                case 'create_tag': return this.createTag(args);
+                default:
+                    return { content: [{ type: 'text', text: `Unknown tool: ${name}` }], isError: true };
+            }
+        }
+        catch (error) {
+            return {
+                content: [{ type: 'text', text: `Tool execution failed: ${error instanceof Error ? error.message : String(error)}` }],
+                isError: true,
+            };
+        }
+    }
+    // ── Private helpers ────────────────────────────────────────────────────────
+    get authHeader() {
+        const credentials = Buffer.from(`${this.apiId}:${this.apiToken}`).toString('base64');
+        return `Basic ${credentials}`;
+    }
+    async request(method, path, params, body) {
+        let url = `${this.baseUrl}${path}`;
+        if (params && Object.keys(params).length > 0) {
+            url += '?' + new URLSearchParams(params).toString();
+        }
+        const init = {
+            method,
+            headers: {
+                Authorization: this.authHeader,
+                'Content-Type': 'application/json',
+                Accept: 'application/json',
+            },
+        };
+        if (body)
+            init.body = JSON.stringify(body);
+        const response = await this.fetchWithRetry(url, init);
+        if (!response.ok) {
+            return {
+                content: [{ type: 'text', text: `API error: ${response.status} ${response.statusText}` }],
+                isError: true,
+            };
+        }
+        if (response.status === 204) {
+            return { content: [{ type: 'text', text: '{"success":true}' }], isError: false };
+        }
+        const data = await response.json();
+        return { content: [{ type: 'text', text: this.truncate(data) }], isError: false };
+    }
+    // ── Calls ──────────────────────────────────────────────────────────────────
+    async listCalls(args) {
+        const params = {
+            per_page: String(args.per_page ?? 20),
+            page: String(args.page ?? 1),
+        };
+        if (args.direction)
+            params.direction = args.direction;
+        if (args.user_id)
+            params.user_id = String(args.user_id);
+        if (args.number_id)
+            params.number_id = String(args.number_id);
+        if (args.from)
+            params.from = String(args.from);
+        if (args.to)
+            params.to = String(args.to);
+        if (args.order)
+            params.order = args.order;
+        return this.request('GET', '/calls', params);
+    }
+    async getCall(args) {
+        if (!args.call_id)
+            return { content: [{ type: 'text', text: 'call_id is required' }], isError: true };
+        return this.request('GET', `/calls/${encodeURIComponent(args.call_id)}`);
+    }
+    async searchCalls(args) {
+        if (!args.query)
+            return { content: [{ type: 'text', text: 'query is required' }], isError: true };
+        const params = {
+            per_page: String(args.per_page ?? 20),
+        };
+        if (args.from)
+            params.from = String(args.from);
+        if (args.to)
+            params.to = String(args.to);
+        // Aircall uses a `filters` query parameter for search
+        params['filters[number]'] = args.query;
+        return this.request('GET', '/calls/search', params);
+    }
+    async addCallTags(args) {
+        if (!args.call_id || !args.tag_ids) {
+            return { content: [{ type: 'text', text: 'call_id and tag_ids are required' }], isError: true };
+        }
+        return this.request('POST', `/calls/${encodeURIComponent(args.call_id)}/tags`, undefined, { tag_ids: args.tag_ids });
+    }
+    async transferCall(args) {
+        if (!args.call_id || !args.user_id) {
+            return { content: [{ type: 'text', text: 'call_id and user_id are required' }], isError: true };
+        }
+        return this.request('POST', `/calls/${encodeURIComponent(args.call_id)}/transfers`, undefined, { user_id: args.user_id });
+    }
+    // ── Users ──────────────────────────────────────────────────────────────────
+    async listUsers(args) {
+        return this.request('GET', '/users', {
+            per_page: String(args.per_page ?? 20),
+            page: String(args.page ?? 1),
+        });
+    }
+    async getUser(args) {
+        if (!args.user_id)
+            return { content: [{ type: 'text', text: 'user_id is required' }], isError: true };
+        return this.request('GET', `/users/${encodeURIComponent(args.user_id)}`);
+    }
+    async createUser(args) {
+        if (!args.email || !args.first_name || !args.last_name) {
+            return { content: [{ type: 'text', text: 'email, first_name, and last_name are required' }], isError: true };
+        }
+        const body = {
+            email: args.email,
+            first_name: args.first_name,
+            last_name: args.last_name,
+        };
+        if (args.role)
+            body.role = args.role;
+        return this.request('POST', '/users', undefined, body);
+    }
+    async updateUser(args) {
+        if (!args.user_id)
+            return { content: [{ type: 'text', text: 'user_id is required' }], isError: true };
+        const { user_id, ...rest } = args;
+        return this.request('PUT', `/users/${user_id}`, undefined, rest);
+    }
+    async deleteUser(args) {
+        if (!args.user_id)
+            return { content: [{ type: 'text', text: 'user_id is required' }], isError: true };
+        return this.request('DELETE', `/users/${encodeURIComponent(args.user_id)}`);
+    }
+    // ── Numbers ────────────────────────────────────────────────────────────────
+    async listNumbers(args) {
+        return this.request('GET', '/numbers', {
+            per_page: String(args.per_page ?? 20),
+            page: String(args.page ?? 1),
+        });
+    }
+    async getNumber(args) {
+        if (!args.number_id)
+            return { content: [{ type: 'text', text: 'number_id is required' }], isError: true };
+        return this.request('GET', `/numbers/${encodeURIComponent(args.number_id)}`);
+    }
+    async updateNumber(args) {
+        if (!args.number_id)
+            return { content: [{ type: 'text', text: 'number_id is required' }], isError: true };
+        const { number_id, ...rest } = args;
+        return this.request('PUT', `/numbers/${number_id}`, undefined, rest);
+    }
+    // ── Teams ──────────────────────────────────────────────────────────────────
+    async listTeams(args) {
+        return this.request('GET', '/teams', {
+            per_page: String(args.per_page ?? 20),
+            page: String(args.page ?? 1),
+        });
+    }
+    async getTeam(args) {
+        if (!args.team_id)
+            return { content: [{ type: 'text', text: 'team_id is required' }], isError: true };
+        return this.request('GET', `/teams/${encodeURIComponent(args.team_id)}`);
+    }
+    async createTeam(args) {
+        if (!args.name)
+            return { content: [{ type: 'text', text: 'name is required' }], isError: true };
+        return this.request('POST', '/teams', undefined, { name: args.name });
+    }
+    async deleteTeam(args) {
+        if (!args.team_id)
+            return { content: [{ type: 'text', text: 'team_id is required' }], isError: true };
+        return this.request('DELETE', `/teams/${encodeURIComponent(args.team_id)}`);
+    }
+    async addUserToTeam(args) {
+        if (!args.team_id || !args.user_id) {
+            return { content: [{ type: 'text', text: 'team_id and user_id are required' }], isError: true };
+        }
+        return this.request('POST', `/teams/${encodeURIComponent(args.team_id)}/users/${encodeURIComponent(args.user_id)}`);
+    }
+    async removeUserFromTeam(args) {
+        if (!args.team_id || !args.user_id) {
+            return { content: [{ type: 'text', text: 'team_id and user_id are required' }], isError: true };
+        }
+        return this.request('DELETE', `/teams/${encodeURIComponent(args.team_id)}/users/${encodeURIComponent(args.user_id)}`);
+    }
+    // ── Contacts ───────────────────────────────────────────────────────────────
+    async listContacts(args) {
+        return this.request('GET', '/contacts', {
+            per_page: String(args.per_page ?? 20),
+            page: String(args.page ?? 1),
+        });
+    }
+    async getContact(args) {
+        if (!args.contact_id)
+            return { content: [{ type: 'text', text: 'contact_id is required' }], isError: true };
+        return this.request('GET', `/contacts/${encodeURIComponent(args.contact_id)}`);
+    }
+    async createContact(args) {
+        if (!args.first_name)
+            return { content: [{ type: 'text', text: 'first_name is required' }], isError: true };
+        const body = { first_name: args.first_name };
+        if (args.last_name)
+            body.last_name = args.last_name;
+        if (args.information)
+            body.information = args.information;
+        return this.request('POST', '/contacts', undefined, body);
+    }
+    async updateContact(args) {
+        if (!args.contact_id)
+            return { content: [{ type: 'text', text: 'contact_id is required' }], isError: true };
+        const { contact_id, ...rest } = args;
+        return this.request('PUT', `/contacts/${contact_id}`, undefined, rest);
+    }
+    async deleteContact(args) {
+        if (!args.contact_id)
+            return { content: [{ type: 'text', text: 'contact_id is required' }], isError: true };
+        return this.request('DELETE', `/contacts/${encodeURIComponent(args.contact_id)}`);
+    }
+    // ── Webhooks ───────────────────────────────────────────────────────────────
+    async listWebhooks() {
+        return this.request('GET', '/webhooks');
+    }
+    async createWebhook(args) {
+        if (!args.url)
+            return { content: [{ type: 'text', text: 'url is required' }], isError: true };
+        const body = { url: args.url };
+        if (args.label)
+            body.label = args.label;
+        if (args.custom_headers)
+            body.custom_headers = args.custom_headers;
+        return this.request('POST', '/webhooks', undefined, body);
+    }
+    async updateWebhook(args) {
+        if (!args.webhook_id)
+            return { content: [{ type: 'text', text: 'webhook_id is required' }], isError: true };
+        const { webhook_id, ...rest } = args;
+        return this.request('PUT', `/webhooks/${webhook_id}`, undefined, rest);
+    }
+    async deleteWebhook(args) {
+        if (!args.webhook_id)
+            return { content: [{ type: 'text', text: 'webhook_id is required' }], isError: true };
+        return this.request('DELETE', `/webhooks/${encodeURIComponent(args.webhook_id)}`);
+    }
+    // ── Tags ───────────────────────────────────────────────────────────────────
+    async listTags() {
+        return this.request('GET', '/tags');
+    }
+    async createTag(args) {
+        if (!args.name)
+            return { content: [{ type: 'text', text: 'name is required' }], isError: true };
+        const body = { name: args.name };
+        if (args.color)
+            body.color = args.color;
+        return this.request('POST', '/tags', undefined, body);
+    }
+}