@linkedapi/mcp 0.3.11

package/.dockerignore

@@ -0,0 +1,11 @@
+node_modules
+npm-debug.log
+.DS_Store
+.git
+.gitignore
+dist
+**/.vscode
+**/.idea
+**/*.log
+coverage
+.env

package/.github/workflows/merge-main.yaml

@@ -0,0 +1,136 @@
+name: PR Merged -> main
+
+on:
+  push:
+    branches: ['main']
+
+permissions:
+  contents: read
+  packages: write
+
+jobs:
+  linting:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4.1.1
+
+      - name: Set up Node.js
+        uses: actions/setup-node@v4.0.1
+        with:
+          node-version: 20
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Run ESLint
+        run: npm run lint
+
+  build:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4.1.1
+
+      - name: Set up Node.js
+        uses: actions/setup-node@v4.0.1
+        with:
+          node-version: 20
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Build
+        run: npm run build
+
+  npm-publish:
+    needs: [linting, build]
+    runs-on: ubuntu-latest
+    if: always() && needs.linting.result == 'success' && needs.build.result == 'success'
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4.1.1
+
+      - name: Set up Node.js
+        uses: actions/setup-node@v4.0.1
+        with:
+          node-version: 20
+          registry-url: 'https://registry.npmjs.org'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Build
+        run: npm run build
+
+      - name: Check if version changed
+        id: version-check
+        run: |
+          PACKAGE_VERSION=$(node -p "require('./package.json').version")
+          NPM_VERSION=$(npm view @linkedapi/mcp version 2>/dev/null || echo "0.0.0")
+          if [ "$PACKAGE_VERSION" != "$NPM_VERSION" ]; then
+            echo "should_publish=true" >> $GITHUB_OUTPUT
+            echo "Version changed: $NPM_VERSION -> $PACKAGE_VERSION"
+          else
+            echo "should_publish=false" >> $GITHUB_OUTPUT
+            echo "Version unchanged: $PACKAGE_VERSION"
+          fi
+
+      - name: Publish to npm
+        if: steps.version-check.outputs.should_publish == 'true'
+        run: npm publish --access public
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+
+  build-push:
+    needs: [linting]
+    runs-on: ubuntu-latest
+    if: always() && needs.linting.result == 'success'
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4.1.1
+
+      - name: Log in to GitHub Container Registry
+        uses: docker/login-action@v3
+        with:
+          registry: ghcr.io
+          username: ${{ github.actor }}
+          password: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@v2
+
+      - name: Set lowercase repository owner
+        id: lowercase
+        run: echo "repository_owner_lowercase=$(echo '${{ github.repository_owner }}' | tr '[:upper:]' '[:lower:]')" >> $GITHUB_OUTPUT
+
+      - name: Build and push
+        uses: docker/build-push-action@v4
+        with:
+          context: .
+          push: true
+          tags: |
+            ghcr.io/${{ steps.lowercase.outputs.repository_owner_lowercase }}/${{ secrets.DOCKER_IMAGE_NAME }}:prod
+          cache-from: type=registry,ref=ghcr.io/${{ steps.lowercase.outputs.repository_owner_lowercase }}/${{ secrets.DOCKER_IMAGE_NAME }}:prod
+          cache-to: type=inline
+
+  deployment:
+    needs: [build-push]
+    runs-on: ubuntu-latest
+    if: always() && needs.build-push.result == 'success'
+
+    steps:
+      - name: Trigger PaaS deployment
+        run: |
+          curl -X 'POST' \
+            '${{ secrets.PAAS_API_URL }}/application.deploy' \
+            -H 'accept: application/json' \
+            -H 'Content-Type: application/json' \
+            -H 'x-api-key: ${{ secrets.PAAS_API_TOKEN }}' \
+            -d '{
+            "applicationId": "${{ secrets.PAAS_APPLICATION_ID }}"
+          }'

package/.github/workflows/pr-main.yaml

@@ -0,0 +1,42 @@
+name: PR Sent -> main
+
+on:
+  pull_request:
+    branches: ['main']
+
+jobs:
+  linting:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4.1.1
+
+      - name: Set up Node.js
+        uses: actions/setup-node@v4.0.1
+        with:
+          node-version: 20
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Run ESLint
+        run: npm run lint
+
+  build:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4.1.1
+
+      - name: Set up Node.js
+        uses: actions/setup-node@v4.0.1
+        with:
+          node-version: 20
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Build
+        run: npm run build

package/.husky/pre-commit

@@ -0,0 +1,5 @@
+npm run clean
+npm run format
+npm run lint
+npm run build
+git add -u

package/.prettierrc.js

@@ -0,0 +1,21 @@
+module.exports = {
+  tabWidth: 2,
+  printWidth: 100,
+  useTabs: false,
+  semi: true,
+  singleQuote: true,
+  trailingComma: "all",
+  bracketSpacing: true,
+  arrowParens: "always",
+  endOfLine: "auto",
+  importOrderSeparation: true,
+  importOrderSortSpecifiers: true,
+  importOrderCaseInsensitive: true,
+  importOrderParserPlugins: [
+    "classProperties",
+    "decorators-legacy",
+    "typescript",
+  ],
+  importOrder: ["<THIRD_PARTY_MODULES>", "^@/(.*)$", "^../(.*)", "^./(.*)"],
+  plugins: ["@trivago/prettier-plugin-sort-imports"],
+};

package/.vscode/launch.json

@@ -0,0 +1,19 @@
+{
+  "version": "1.0.0",
+  "configurations": [
+    {
+      "type": "node-terminal",
+      "name": "Linked API MCP - HTTP",
+      "request": "launch",
+      "command": "npm run dev:http",
+      "envFile": "${workspaceFolder}/.env"
+    },
+    {
+      "type": "node-terminal",
+      "name": "Linked API MCP - STDIO",
+      "request": "launch",
+      "command": "npm run dev:stdio",
+      "envFile": "${workspaceFolder}/.env"
+    },
+  ]
+}

package/Dockerfile

@@ -0,0 +1,39 @@
+FROM node:20-slim AS deps
+WORKDIR /app
+
+# Copy package files
+COPY package.json package-lock.json* ./
+
+# Install production dependencies only
+RUN npm ci --omit=dev --legacy-peer-deps --ignore-scripts
+
+FROM node:20-slim AS builder
+WORKDIR /app
+
+# Copy package files
+COPY package.json package-lock.json* ./
+
+# Install all dependencies (including dev)
+RUN HUSKY=0 npm ci --legacy-peer-deps
+
+# Copy sources and build
+COPY tsconfig.json ./
+COPY src ./src
+COPY README.md ./README.md
+RUN npm run build
+
+FROM node:20-slim AS runner
+ENV NODE_ENV=production
+WORKDIR /app
+
+# Copy production node_modules and built app
+COPY --from=deps /app/node_modules ./node_modules
+COPY --from=builder /app/dist ./dist
+COPY --from=builder /app/package.json ./
+
+ENV HOST=0.0.0.0 \
+    PORT=3000
+
+EXPOSE 3000
+
+CMD ["node", "dist/index.js", "--http"]

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Linked API
+
+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,17 @@
+Linked API MCP server connects your LinkedIn account to AI assistants like Claude, Cursor, and VS Code. Ask them to search for leads, send messages, analyze profiles, and much more – they'll handle it through our cloud browser, safely and automatically.
+
+## Use cases
+- **Sales automation assistant**. Ask your AI to find leads, check their profiles, and draft personalized outreach. It can search for "software engineers at companies with 50-200 employees in San Francisco", analyze their backgrounds, and suggest connection messages that actually make sense.
+- **Recruitment assistant**. Let your assistant search for candidates with specific skills, review their experience, and send initial outreach. It handles the time-consuming parts while you focus on actually talking to people.
+- **Conversation assistant**. Your AI can read your existing LinkedIn conversations and help you respond naturally. It understands the context of your chats, suggests relevant replies, and can even send follow-up messages.
+- **Market research assistant**. Need competitor analysis? Your assistant can gather data about companies, their employees, and recent activities. Get insights about industry trends without spending hours on LinkedIn.
+
+## Get started
+To start using Linked API MCP, spend 2 minutes reading these essential guides:
+
+1. [Installation](https://linkedapi.io/mcp/installation/) – set up MCP in Claude, Cursor, VS Code, or Windsurf.
+2. [Available tools](https://linkedapi.io/mcp/available-tools/) – explore all the LinkedIn tools your assistant can call.
+3. [Usage examples](https://linkedapi.io/mcp/usage-examples/) – see real-world examples to get you started quickly.
+
+## License
+This project is licensed under the MIT – see the [LICENSE](https://github.com/Linked-API/linkedapi-mcp/blob/main/LICENSE) file for details.

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,189 @@
+#!/usr/bin/env node
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const index_js_1 = require("@modelcontextprotocol/sdk/server/index.js");
+const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
+const types_js_1 = require("@modelcontextprotocol/sdk/types.js");
+const node_http_1 = __importDefault(require("node:http"));
+const linked_api_server_1 = require("./linked-api-server");
+const prompts_1 = require("./prompts");
+const json_http_transport_1 = require("./utils/json-http-transport");
+const logger_1 = require("./utils/logger");
+function deriveClientFromUserAgent(userAgent) {
+    const ua = userAgent.toLowerCase();
+    if (ua.includes('cursor'))
+        return 'cursor';
+    if (ua.includes('windsurf'))
+        return 'windsurf';
+    if (ua.includes('vscode') || ua.includes('visual studio code'))
+        return 'vscode';
+    if (ua.includes('chatgpt') || ua.includes('openai'))
+        return 'chatgpt';
+    if (ua.includes('curl'))
+        return 'curl';
+    if (ua.includes('postman'))
+        return 'postman';
+    if (ua.includes('mozilla') ||
+        ua.includes('chrome') ||
+        ua.includes('safari') ||
+        ua.includes('firefox'))
+        return 'browser';
+    return userAgent;
+}
+function getArgValue(flag) {
+    const index = process.argv.indexOf(flag);
+    if (index === -1)
+        return undefined;
+    const value = process.argv[index + 1];
+    if (!value || value.startsWith('--'))
+        return undefined;
+    return value;
+}
+function hasFlag(flag) {
+    return process.argv.includes(flag);
+}
+async function main() {
+    const server = new index_js_1.Server({
+        name: 'linkedapi-mcp',
+        version: '1.0.0',
+        description: 'MCP Server for Linked API (https://linkedapi.io)',
+    }, {
+        capabilities: {
+            tools: {},
+            prompts: {},
+        },
+        instructions: prompts_1.systemPrompt,
+    });
+    const progressCallback = (_notification) => { };
+    const linkedApiServer = new linked_api_server_1.LinkedApiMCPServer(progressCallback);
+    server.setRequestHandler(types_js_1.ListToolsRequestSchema, async () => {
+        const tools = linkedApiServer.getTools();
+        return {
+            tools,
+        };
+    });
+    server.setRequestHandler(types_js_1.ListPromptsRequestSchema, async () => {
+        return {
+            prompts: prompts_1.availablePrompts,
+        };
+    });
+    server.setRequestHandler(types_js_1.GetPromptRequestSchema, async (request) => {
+        const { name } = request.params;
+        try {
+            const content = name === 'performance_guidelines' ? prompts_1.systemPrompt : (0, prompts_1.getPromptContent)(name);
+            return {
+                description: `Linked API MCP: ${name.replace('_', ' ')}`,
+                messages: [
+                    {
+                        role: 'user',
+                        content: {
+                            type: 'text',
+                            text: content,
+                        },
+                    },
+                ],
+            };
+        }
+        catch {
+            throw new Error(`Unknown prompt: ${name}`);
+        }
+    });
+    server.setRequestHandler(types_js_1.CallToolRequestSchema, async (request, extra) => {
+        const requestInfoAny = extra?.requestInfo;
+        const method = requestInfoAny?.method ?? 'N/A';
+        const transportType = requestInfoAny?.transport ?? 'N/A';
+        logger_1.logger.info({
+            method,
+            transport: transportType,
+        }, 'Tool request received');
+        try {
+            const localLinkedApiToken = process.env.LINKED_API_TOKEN;
+            const localIdentificationToken = process.env.IDENTIFICATION_TOKEN;
+            const headers = extra?.requestInfo?.headers ?? {};
+            const linkedApiToken = (headers['linked-api-token'] ?? localLinkedApiToken ?? '');
+            const identificationToken = (headers['identification-token'] ??
+                localIdentificationToken ??
+                '');
+            let mcpClient = (headers['client'] ?? '');
+            if (!mcpClient) {
+                const userAgentHeader = headers['user-agent'];
+                if (typeof userAgentHeader === 'string' && userAgentHeader.trim().length > 0) {
+                    mcpClient = deriveClientFromUserAgent(userAgentHeader);
+                }
+            }
+            const result = await linkedApiServer.executeWithTokens(request.params, {
+                linkedApiToken,
+                identificationToken,
+                mcpClient,
+            });
+            return result;
+        }
+        catch (error) {
+            logger_1.logger.error({
+                toolName: request.params.name,
+                error: error instanceof Error ? error.message : String(error),
+            }, 'Critical tool execution error');
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: 'Unknown error. Please try again.',
+                    },
+                ],
+            };
+        }
+    });
+    if (hasFlag('--http') || hasFlag('--transport=http')) {
+        const port = Number(process.env.PORT ?? getArgValue('--port') ?? 3000);
+        const host = process.env.HOST ?? getArgValue('--host') ?? '0.0.0.0';
+        const transport = new json_http_transport_1.JsonHTTPServerTransport();
+        await server.connect(transport);
+        const httpServer = node_http_1.default.createServer(async (req, res) => {
+            try {
+                if (!req.url) {
+                    res.statusCode = 400;
+                    res.end('Bad Request');
+                    return;
+                }
+                const url = new URL(req.url, `http://${req.headers.host ?? 'localhost'}`);
+                // Set query parameters to headers if they are not set
+                const linkedApiTokenQP = url.searchParams.get('linked-api-token');
+                const identificationTokenQP = url.searchParams.get('identification-token');
+                const mcpClient = url.searchParams.get('client');
+                if (!req.headers['linked-api-token'] && linkedApiTokenQP) {
+                    req.headers['linked-api-token'] = linkedApiTokenQP;
+                }
+                if (!req.headers['identification-token'] && identificationTokenQP) {
+                    req.headers['identification-token'] = identificationTokenQP;
+                }
+                if (!req.headers['client'] && mcpClient) {
+                    req.headers['client'] = mcpClient;
+                }
+                await transport.handleRequest(req, res);
+            }
+            catch (error) {
+                logger_1.logger.error({
+                    error: error instanceof Error ? error.message : String(error),
+                }, 'HTTP request handling failed');
+                res.statusCode = 500;
+                res.end('Internal Server Error');
+            }
+        });
+        httpServer.listen(port, host, () => {
+            logger_1.logger.info({ host }, `HTTP transport listening on port ${port}`);
+        });
+    }
+    else {
+        const transport = new stdio_js_1.StdioServerTransport();
+        await server.connect(transport);
+        logger_1.logger.info('stdio transport connected');
+    }
+}
+main().catch((error) => {
+    logger_1.logger.error(error, 'Fatal 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/linked-api-server.d.ts

@@ -0,0 +1,13 @@
+import { TLinkedApiConfig } from '@linkedapi/node';
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+import { CallToolResult, ExtendedCallToolRequest, LinkedApiProgressNotification } from './utils/types';
+export declare class LinkedApiMCPServer {
+    private tools;
+    constructor(progressCallback: (notification: LinkedApiProgressNotification) => void);
+    getTools(): Tool[];
+    executeWithTokens(request: ExtendedCallToolRequest['params'], { linkedApiToken, identificationToken, mcpClient }: TLinkedApiConfig & {
+        mcpClient: string;
+    }): Promise<CallToolResult>;
+    private calculateDuration;
+}
+//# sourceMappingURL=linked-api-server.d.ts.map

package/dist/linked-api-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"linked-api-server.d.ts","sourceRoot":"","sources":["../src/linked-api-server.ts"],"names":[],"mappings":"AAAA,OAAO,EAA6B,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAE9E,OAAO,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAM1D,OAAO,EACL,cAAc,EACd,uBAAuB,EACvB,6BAA6B,EAC9B,MAAM,eAAe,CAAC;AAEvB,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,KAAK,CAAiB;gBAElB,gBAAgB,EAAE,CAAC,YAAY,EAAE,6BAA6B,KAAK,IAAI;IAI5E,QAAQ,IAAI,IAAI,EAAE;IAIZ,iBAAiB,CAC5B,OAAO,EAAE,uBAAuB,CAAC,QAAQ,CAAC,EAC1C,EAAE,cAAc,EAAE,mBAAmB,EAAE,SAAS,EAAE,EAAE,gBAAgB,GAAG;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,GAC3F,OAAO,CAAC,cAAc,CAAC;IA8H1B,OAAO,CAAC,iBAAiB;CAI1B"}

package/dist/linked-api-server.js

@@ -0,0 +1,127 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LinkedApiMCPServer = void 0;
+const node_1 = require("@linkedapi/node");
+const core_1 = require("@linkedapi/node/dist/core");
+const linked_api_tools_1 = require("./linked-api-tools");
+const define_request_timeout_1 = require("./utils/define-request-timeout");
+const handle_linked_api_error_1 = require("./utils/handle-linked-api-error");
+const logger_1 = require("./utils/logger");
+class LinkedApiMCPServer {
+    tools;
+    constructor(progressCallback) {
+        this.tools = new linked_api_tools_1.LinkedApiTools(progressCallback);
+    }
+    getTools() {
+        return this.tools.tools.map((tool) => tool.getTool());
+    }
+    async executeWithTokens(request, { linkedApiToken, identificationToken, mcpClient }) {
+        const workflowTimeout = (0, define_request_timeout_1.defineRequestTimeoutInSeconds)(mcpClient) * 1000;
+        logger_1.logger.info({
+            toolName: request.name,
+            arguments: request.arguments,
+            mcpClient,
+            workflowTimeout,
+        }, 'Tool execution started');
+        const linkedapi = new node_1.LinkedApi((0, core_1.buildLinkedApiHttpClient)({
+            linkedApiToken: linkedApiToken,
+            identificationToken: identificationToken,
+        }, 'mcp'));
+        const { name: toolName, arguments: args, _meta } = request;
+        const progressToken = _meta?.progressToken;
+        const startTime = Date.now();
+        try {
+            const tool = this.tools.toolByName(toolName);
+            if (!tool) {
+                throw new Error(`Unknown tool: ${toolName}`);
+            }
+            const params = tool.validate(args);
+            const { data, errors } = await tool.execute({
+                linkedapi,
+                args: params,
+                workflowTimeout,
+                progressToken,
+            });
+            const endTime = Date.now();
+            const duration = `${((endTime - startTime) / 1000).toFixed(2)} seconds`;
+            if (errors.length > 0 && !data) {
+                logger_1.logger.error({
+                    toolName,
+                    duration,
+                    errors,
+                }, 'Tool execution failed');
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: errors.map((e) => e.message).join('\n'),
+                        },
+                    ],
+                };
+            }
+            logger_1.logger.info({
+                toolName,
+                duration,
+                data,
+            }, 'Tool execution successful');
+            if (data) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify(data, null, 2),
+                        },
+                    ],
+                };
+            }
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: 'Completed',
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            const duration = this.calculateDuration(startTime);
+            if (error instanceof node_1.LinkedApiError) {
+                const body = (0, handle_linked_api_error_1.handleLinkedApiError)(error);
+                logger_1.logger.error({
+                    toolName,
+                    duration,
+                    body,
+                }, 'Tool execution failed with Linked API error');
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify(body, null, 2),
+                        },
+                    ],
+                };
+            }
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            logger_1.logger.error({
+                toolName,
+                duration,
+                error: errorMessage,
+                stack: error instanceof Error ? error.stack : undefined,
+            }, 'Tool execution failed with unknown error');
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Error executing ${toolName}: ${errorMessage}`,
+                    },
+                ],
+            };
+        }
+    }
+    calculateDuration(startTime) {
+        const endTime = Date.now();
+        return `${((endTime - startTime) / 1000).toFixed(2)} seconds`;
+    }
+}
+exports.LinkedApiMCPServer = LinkedApiMCPServer;
+//# sourceMappingURL=linked-api-server.js.map