worklink-mcp 1.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 md-ar
+
+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,127 @@
+# worklink-mcp
+
+[![npm version](https://img.shields.io/npm/v/worklink-mcp.svg)](https://www.npmjs.com/package/worklink-mcp)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+MCP server for the [WorkLink Partner API](https://worklink.sy/api/partner/docs) — search live job vacancies and tenders in Syria.
+
+## Get a Token
+
+1. Go to https://worklink.sy/api-access
+2. Fill the form (choose vacancies and/or tenders)
+3. Wait for WorkLink to issue your token
+
+## Install
+
+No installation needed — run directly with `npx`:
+
+```bash
+npx -y worklink-mcp
+```
+
+## Configure
+
+### Claude Desktop
+
+Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "worklink": {
+      "command": "npx",
+      "args": ["-y", "worklink-mcp"],
+      "env": {
+        "WORKLINK_API_TOKEN": "your-token-here"
+      }
+    }
+  }
+}
+```
+
+### OpenCode
+
+Add to `.opencode.json`:
+
+```json
+{
+  "mcp": {
+    "worklink": {
+      "command": "npx",
+      "args": ["-y", "worklink-mcp"],
+      "env": {
+        "WORKLINK_API_TOKEN": "your-token-here"
+      }
+    }
+  }
+}
+```
+
+### Cursor / Windsurf
+
+Add to your MCP settings (`.cursor/mcp.json` or equivalent):
+
+```json
+{
+  "mcpServers": {
+    "worklink": {
+      "command": "npx",
+      "args": ["-y", "worklink-mcp"],
+      "env": {
+        "WORKLINK_API_TOKEN": "your-token-here"
+      }
+    }
+  }
+}
+```
+
+### ChatGPT
+
+In ChatGPT settings > MCP Servers > Add server:
+
+- **Command:** `npx -y worklink-mcp`
+- **Env:** `WORKLINK_API_TOKEN=your-token-here`
+
+## Tools
+
+| Tool | Description |
+|------|-------------|
+| `list_vacancies` | List active job vacancies with pagination, category/company/open filters |
+| `get_vacancy` | Get full details of a single vacancy by slug |
+| `list_tenders` | List published tenders with pagination and filters |
+| `get_tender` | Get tender preview by slug (full body on WorkLink) |
+
+## Example Prompts
+
+Once configured, ask your AI assistant:
+
+- "Show me the latest job vacancies in Damascus"
+- "Find engineering jobs with salary above 500"
+- "What tenders are open this month?"
+- "Get details for the vacancy at company X"
+
+## Troubleshooting
+
+### "WORKLINK_API_TOKEN environment variable is required"
+
+The token is missing. Make sure you set `WORKLINK_API_TOKEN` in the MCP server config's `env` block (see Configure section above).
+
+### "WorkLink API error (401): Unauthorized"
+
+Your token is invalid or expired. Get a new one at https://worklink.sy/api-access.
+
+### "WorkLink API error (429): Too Many Requests"
+
+You've hit the rate limit (120 requests/minute). The server automatically retries with exponential backoff, but if this persists, wait a minute before trying again.
+
+### Request timed out
+
+The server has a 30-second timeout per request. If WorkLink's API is slow, the request will be retried up to 3 times before failing.
+
+## Rate Limiting
+
+The server respects WorkLink's 120 requests/minute limit with built-in throttling. If the limit is hit, requests are automatically retried with exponential backoff.
+
+## License
+
+MIT

package/dist/api-client.d.ts

@@ -0,0 +1,24 @@
+export declare class WorkLinkClient {
+    private token;
+    private requestTimes;
+    private readonly MAX_REQUESTS_PER_MINUTE;
+    constructor(token: string);
+    private throttle;
+    fetch<T>(path: string, params?: Record<string, string | number | undefined>): Promise<T>;
+    getVacancies(params?: {
+        page?: number;
+        per_page?: number;
+        category?: number;
+        company?: number;
+        open?: 0 | 1;
+    }): Promise<unknown>;
+    getVacancy(slug: string): Promise<unknown>;
+    getTenders(params?: {
+        page?: number;
+        per_page?: number;
+        category?: number;
+        company?: number;
+        open?: 0 | 1;
+    }): Promise<unknown>;
+    getTender(slug: string): Promise<unknown>;
+}

package/dist/api-client.js

@@ -0,0 +1,102 @@
+const BASE_URL = "https://worklink.sy/api/partner";
+const REQUEST_TIMEOUT_MS = 30_000;
+const MAX_RETRIES = 3;
+const RETRY_BASE_MS = 1_000;
+export class WorkLinkClient {
+    token;
+    requestTimes = [];
+    MAX_REQUESTS_PER_MINUTE = 120;
+    constructor(token) {
+        this.token = token;
+    }
+    async throttle() {
+        const now = Date.now();
+        this.requestTimes = this.requestTimes.filter((t) => now - t < 60_000);
+        if (this.requestTimes.length >= this.MAX_REQUESTS_PER_MINUTE) {
+            const oldest = this.requestTimes[0];
+            const waitMs = 60_000 - (now - oldest) + 100;
+            await new Promise((resolve) => setTimeout(resolve, waitMs));
+            this.requestTimes = this.requestTimes.filter((t) => Date.now() - t < 60_000);
+        }
+        this.requestTimes.push(Date.now());
+    }
+    async fetch(path, params) {
+        const url = new URL(`${BASE_URL}${path}`);
+        if (params) {
+            for (const [key, value] of Object.entries(params)) {
+                if (value !== undefined && value !== null) {
+                    url.searchParams.set(key, String(value));
+                }
+            }
+        }
+        let lastError;
+        for (let attempt = 0; attempt <= MAX_RETRIES; attempt++) {
+            await this.throttle();
+            try {
+                const controller = new AbortController();
+                const timeout = setTimeout(() => controller.abort(), REQUEST_TIMEOUT_MS);
+                let res;
+                try {
+                    res = await fetch(url.toString(), {
+                        headers: {
+                            Authorization: `Bearer ${this.token}`,
+                            Accept: "application/json",
+                        },
+                        signal: controller.signal,
+                    });
+                }
+                finally {
+                    clearTimeout(timeout);
+                }
+                if (res.status === 429) {
+                    const retryAfter = res.headers.get("Retry-After");
+                    const waitMs = retryAfter
+                        ? parseInt(retryAfter, 10) * 1000
+                        : RETRY_BASE_MS * Math.pow(2, attempt);
+                    if (attempt < MAX_RETRIES) {
+                        await new Promise((r) => setTimeout(r, waitMs));
+                        continue;
+                    }
+                }
+                if (!res.ok) {
+                    let errorMsg = `HTTP ${res.status}`;
+                    try {
+                        const body = await res.json();
+                        errorMsg = body.message || body.error || errorMsg;
+                    }
+                    catch {
+                        // ignore parse error
+                    }
+                    throw new Error(`WorkLink API error (${res.status}): ${errorMsg}`);
+                }
+                return res.json();
+            }
+            catch (error) {
+                if (error instanceof Error && error.name === "AbortError") {
+                    lastError = new Error(`Request to ${path} timed out after ${REQUEST_TIMEOUT_MS / 1000}s`);
+                    if (attempt < MAX_RETRIES) {
+                        await new Promise((r) => setTimeout(r, RETRY_BASE_MS * Math.pow(2, attempt)));
+                        continue;
+                    }
+                }
+                else {
+                    throw error;
+                }
+            }
+        }
+        throw lastError ?? new Error(`Failed to fetch ${path} after ${MAX_RETRIES + 1} attempts`);
+    }
+    async getVacancies(params) {
+        return this.fetch("/vacancies", params);
+    }
+    async getVacancy(slug) {
+        return this.fetch(`/vacancies/${encodeURIComponent(slug)}`);
+    }
+    async getTenders(params) {
+        return this.fetch("/tenders", params);
+    }
+    async getTender(slug) {
+        return this.fetch(`/tenders/${encodeURIComponent(slug)}`);
+    }
+}
+//# sourceMappingURL=api-client.js.map

package/dist/api-client.js.map

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

package/dist/index.d.ts

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

package/dist/index.js

@@ -0,0 +1,31 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { WorkLinkClient } from "./api-client.js";
+import { registerVacancyTools } from "./tools/vacancies.js";
+import { registerTenderTools } from "./tools/tenders.js";
+const token = process.env.WORKLINK_API_TOKEN;
+if (!token) {
+    console.error("Error: WORKLINK_API_TOKEN environment variable is required.\n" +
+        "Get a token at https://worklink.sy/api-access");
+    process.exit(1);
+}
+const client = new WorkLinkClient(token);
+const server = new McpServer({
+    name: "worklink",
+    version: "1.0.1",
+});
+registerVacancyTools(server, client);
+registerTenderTools(server, client);
+const transport = new StdioServerTransport();
+await server.connect(transport);
+console.error("worklink-mcp server running on stdio");
+process.on("SIGINT", async () => {
+    await server.close();
+    process.exit(0);
+});
+process.on("SIGTERM", async () => {
+    await server.close();
+    process.exit(0);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAEzD,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC;AAC7C,IAAI,CAAC,KAAK,EAAE,CAAC;IACX,OAAO,CAAC,KAAK,CACX,+DAA+D;QAC/D,+CAA+C,CAChD,CAAC;IACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,MAAM,MAAM,GAAG,IAAI,cAAc,CAAC,KAAK,CAAC,CAAC;AAEzC,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;IAC3B,IAAI,EAAE,UAAU;IAChB,OAAO,EAAE,OAAO;CACjB,CAAC,CAAC;AAEH,oBAAoB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AACrC,mBAAmB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAEpC,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;AAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AAEhC,OAAO,CAAC,KAAK,CAAC,sCAAsC,CAAC,CAAC;AAEtD,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,KAAK,IAAI,EAAE;IAC9B,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;IACrB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC;AACH,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,KAAK,IAAI,EAAE;IAC/B,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;IACrB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/tools/tenders.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { WorkLinkClient } from "../api-client.js";
+export declare function registerTenderTools(server: McpServer, client: WorkLinkClient): void;

package/dist/tools/tenders.js

@@ -0,0 +1,92 @@
+import { z } from "zod";
+function formatTender(t) {
+    const lines = [];
+    lines.push(`# ${t.title}`);
+    lines.push("");
+    if (t.company)
+        lines.push(`**Company:** ${t.company.name}`);
+    if (t.category)
+        lines.push(`**Category:** ${t.category.name}`);
+    if (t.location)
+        lines.push(`**Location:** ${t.location}`);
+    if (t.deadline)
+        lines.push(`**Deadline:** ${t.deadline}`);
+    lines.push("");
+    lines.push("**Preview:**");
+    lines.push(t.preview);
+    lines.push("");
+    lines.push(`**View full tender and apply:** ${t.url}`);
+    return lines.join("\n");
+}
+function formatList(result, label) {
+    const lines = [];
+    lines.push(`## ${label} (page ${result.meta.current_page}/${result.meta.last_page}, ${result.meta.total} total)`);
+    lines.push("");
+    for (const t of result.data) {
+        const company = t.company?.name ?? "Unknown";
+        const category = t.category?.name ?? "";
+        const location = t.location ?? "Not specified";
+        const deadline = t.deadline ?? "None";
+        lines.push(`### ${t.title}`);
+        lines.push(`- **Company:** ${company}`);
+        if (category)
+            lines.push(`- **Category:** ${category}`);
+        lines.push(`- **Location:** ${location}`);
+        lines.push(`- **Deadline:** ${deadline}`);
+        const preview = t.preview.length > 300
+            ? t.preview.substring(0, 300).trimEnd() + "..."
+            : t.preview;
+        lines.push(`- **Preview:** ${preview}`);
+        lines.push(`- **Link:** ${t.url}`);
+        lines.push("");
+    }
+    if (result.meta.last_page > result.meta.current_page) {
+        lines.push(`_More pages available (page ${result.meta.current_page + 1} of ${result.meta.last_page}). Use page parameter to see more._`);
+    }
+    return lines.join("\n");
+}
+export function registerTenderTools(server, client) {
+    server.registerTool("list_tenders", {
+        description: "List published tenders from WorkLink Syria. Returns paginated results with title, company, location, preview text, and link to full tender.",
+        inputSchema: {
+            page: z.number().int().min(1).optional().describe("Page number (default: 1)"),
+            per_page: z.number().int().min(1).max(50).optional().describe("Results per page, 1-50 (default: 20)"),
+            category: z.number().int().optional().describe("Filter by category ID"),
+            company: z.number().int().optional().describe("Filter by company ID"),
+            open: z.union([z.literal(0), z.literal(1)]).optional().describe("1 = only currently-open items (no deadline or deadline is today or later)"),
+        },
+    }, async (args) => {
+        try {
+            const result = await client.getTenders(args);
+            return {
+                content: [{ type: "text", text: formatList(result, "Tenders") }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: `Error listing tenders: ${error instanceof Error ? error.message : String(error)}` }],
+                isError: true,
+            };
+        }
+    });
+    server.registerTool("get_tender", {
+        description: "Get details of a single tender by its slug. Returns preview text only (full body is on WorkLink). Always includes link to view full tender and apply.",
+        inputSchema: {
+            slug: z.string().describe("The tender slug (from the URL or from list_tenders results)"),
+        },
+    }, async (args) => {
+        try {
+            const result = await client.getTender(args.slug);
+            return {
+                content: [{ type: "text", text: formatTender(result.data) }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: `Error getting tender: ${error instanceof Error ? error.message : String(error)}` }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=tenders.js.map

package/dist/tools/tenders.js.map

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

package/dist/tools/vacancies.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { WorkLinkClient } from "../api-client.js";
+export declare function registerVacancyTools(server: McpServer, client: WorkLinkClient): void;

package/dist/tools/vacancies.js

@@ -0,0 +1,123 @@
+import { z } from "zod";
+function formatVacancy(v) {
+    const lines = [];
+    lines.push(`# ${v.title}`);
+    lines.push("");
+    if (v.company)
+        lines.push(`**Company:** ${v.company.name}`);
+    if (v.category)
+        lines.push(`**Category:** ${v.category.name}`);
+    if (v.type)
+        lines.push(`**Type:** ${v.type}`);
+    if (v.salary)
+        lines.push(`**Salary:** ${v.salary}`);
+    if (v.locations?.length)
+        lines.push(`**Locations:** ${v.locations.join(", ")}`);
+    if (v.deadline)
+        lines.push(`**Deadline:** ${v.deadline}`);
+    lines.push(`**Link:** ${v.url}`);
+    lines.push("");
+    if (v.description) {
+        const text = stripHtml(v.description);
+        lines.push(text);
+    }
+    return lines.join("\n");
+}
+function stripHtml(html) {
+    return html
+        .replace(/<br\s*\/?>/gi, "\n")
+        .replace(/<\/?(p|div|h[1-6]|li|tr)[^>]*>/gi, "\n")
+        .replace(/<[^>]+>/g, " ")
+        .replace(/&amp;/g, "&")
+        .replace(/&lt;/g, "<")
+        .replace(/&gt;/g, ">")
+        .replace(/&quot;/g, '"')
+        .replace(/&#039;|&apos;/g, "'")
+        .replace(/&nbsp;/g, " ")
+        .replace(/\n{3,}/g, "\n\n")
+        .replace(/[ \t]+/g, " ")
+        .trim();
+}
+function truncate(text, maxLen) {
+    if (text.length <= maxLen)
+        return text;
+    return text.substring(0, maxLen).trimEnd() + "...";
+}
+function formatList(result, label) {
+    const lines = [];
+    lines.push(`## ${label} (page ${result.meta.current_page}/${result.meta.last_page}, ${result.meta.total} total)`);
+    lines.push("");
+    for (const v of result.data) {
+        const company = v.company?.name ?? "Unknown";
+        const type = v.type ?? "";
+        const category = v.category?.name ?? "";
+        const salary = v.salary ?? "Not specified";
+        const locations = v.locations?.join(", ") ?? "";
+        const deadline = v.deadline ?? "None";
+        lines.push(`### ${v.title}`);
+        lines.push(`- **Company:** ${company}`);
+        if (type)
+            lines.push(`- **Type:** ${type}`);
+        if (category)
+            lines.push(`- **Category:** ${category}`);
+        lines.push(`- **Salary:** ${salary}`);
+        if (locations)
+            lines.push(`- **Locations:** ${locations}`);
+        lines.push(`- **Deadline:** ${deadline}`);
+        if (v.description) {
+            const preview = truncate(stripHtml(v.description), 200);
+            lines.push(`- **Preview:** ${preview}`);
+        }
+        lines.push(`- **Link:** ${v.url}`);
+        lines.push("");
+    }
+    if (result.meta.last_page > result.meta.current_page) {
+        lines.push(`_More pages available (page ${result.meta.current_page + 1} of ${result.meta.last_page}). Use page parameter to see more._`);
+    }
+    return lines.join("\n");
+}
+export function registerVacancyTools(server, client) {
+    server.registerTool("list_vacancies", {
+        description: "List active job vacancies from WorkLink Syria. Returns paginated results with title, company, salary, locations, and apply link.",
+        inputSchema: {
+            page: z.number().int().min(1).optional().describe("Page number (default: 1)"),
+            per_page: z.number().int().min(1).max(50).optional().describe("Results per page, 1-50 (default: 20)"),
+            category: z.number().int().optional().describe("Filter by category ID"),
+            company: z.number().int().optional().describe("Filter by company ID"),
+            open: z.union([z.literal(0), z.literal(1)]).optional().describe("1 = only currently-open items (no deadline or deadline is today or later)"),
+        },
+    }, async (args) => {
+        try {
+            const result = await client.getVacancies(args);
+            return {
+                content: [{ type: "text", text: formatList(result, "Job Vacancies") }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: `Error listing vacancies: ${error instanceof Error ? error.message : String(error)}` }],
+                isError: true,
+            };
+        }
+    });
+    server.registerTool("get_vacancy", {
+        description: "Get full details of a single job vacancy by its slug. Returns title, description (HTML), salary, type, company, locations, deadline, and apply link.",
+        inputSchema: {
+            slug: z.string().describe("The vacancy slug (from the URL or from list_vacancies results)"),
+        },
+    }, async (args) => {
+        try {
+            const result = await client.getVacancy(args.slug);
+            return {
+                content: [{ type: "text", text: formatVacancy(result.data) }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: `Error getting vacancy: ${error instanceof Error ? error.message : String(error)}` }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=vacancies.js.map

package/dist/tools/vacancies.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,54 @@
+export interface Category {
+    id: number;
+    name: string;
+}
+export interface Company {
+    name: string;
+    slug: string;
+}
+export interface Vacancy {
+    id: number;
+    title: string;
+    slug: string;
+    description: string;
+    salary: string | null;
+    type: string | null;
+    category?: Category;
+    company?: Company;
+    locations: string[];
+    deadline: string | null;
+    url: string;
+}
+export interface Tender {
+    id: number;
+    title: string;
+    slug: string;
+    preview: string;
+    category?: Category;
+    company?: Company;
+    location: string | null;
+    deadline: string | null;
+    url: string;
+}
+export interface PaginationMeta {
+    current_page: number;
+    last_page: number;
+    per_page: number;
+    total: number;
+    from: number;
+    to: number;
+}
+export interface PaginationLinks {
+    first: string;
+    last: string;
+    prev: string | null;
+    next: string | null;
+}
+export interface PaginatedResponse<T> {
+    data: T[];
+    links: PaginationLinks;
+    meta: PaginationMeta;
+}
+export interface SingleResponse<T> {
+    data: T;
+}

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,37 @@
+{
+  "name": "worklink-mcp",
+  "version": "1.0.1",
+  "description": "MCP server for WorkLink Partner API — search Syria jobs and tenders",
+  "main": "dist/index.js",
+  "mcpName": "worklink-mcp",
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "dev": "tsx src/index.ts",
+    "prepublishOnly": "npm run build",
+    "typecheck": "tsc --noEmit"
+  },
+  "keywords": ["mcp", "worklink", "syria", "jobs", "tenders"],
+  "author": "md-ar",
+  "license": "MIT",
+  "type": "module",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "bin": {
+    "worklink-mcp": "dist/index.js"
+  },
+  "files": ["dist/**/*", "README.md", "LICENSE"],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "zod": "^3.25.0"
+  },
+  "devDependencies": {
+    "@types/node": "^26.1.1",
+    "tsx": "^4.23.1",
+    "typescript": "^7.0.2"
+  }
+}