@tarielai/mcp-client 0.1.0

package/README.md

@@ -0,0 +1,27 @@
+# @tarielai/mcp-client
+
+Typed [Model Context Protocol](https://modelcontextprotocol.io/) client for the Tariel app (`/api/mcp`).
+
+## Install
+
+Public registry (recommended):
+
+```bash
+npm install @tarielai/mcp-client
+```
+## Usage
+
+```typescript
+import { TarielMcpClient } from "@tarielai/mcp-client";
+
+const client = new TarielMcpClient({
+  baseUrl: "https://YOUR_APP_ORIGIN",
+  accessToken: process.env.TARIEL_ACCESS_TOKEN!,
+});
+
+await client.connect();
+const agents = await client.agents.list();
+await client.close();
+```
+
+Requires a Tariel account with **FEATURE_MCP** and an MCP-scoped API key (`pf_live_*`).

package/dist/index.d.ts

@@ -0,0 +1,57 @@
+export type TarielMcpClientOptions = {
+    /** App origin, e.g. https://app.tariel.ai (no trailing slash). */
+    baseUrl: string;
+    /** Personal API key (pf_live_…) or Keycloak access JWT. */
+    accessToken: string;
+};
+export declare class TarielMcpClient {
+    private readonly baseUrl;
+    private readonly accessToken;
+    private client;
+    private transport;
+    constructor(options: TarielMcpClientOptions);
+    get mcpUrl(): string;
+    connect(): Promise<void>;
+    close(): Promise<void>;
+    callTool<T = unknown>(name: string, args?: Record<string, unknown>): Promise<T>;
+    readonly projection: {
+        export: (args: {
+            asset: string;
+            exchange?: string;
+            agg?: number;
+            time?: string;
+            t?: string;
+            format?: "json" | "markdown" | "md" | "svg";
+        }) => Promise<string>;
+        credits: () => Promise<unknown>;
+    };
+    readonly news: {
+        list: (args: Record<string, unknown>) => Promise<unknown>;
+        article: (args: {
+            articleId: string;
+            asset?: string;
+        }) => Promise<unknown>;
+    };
+    readonly anchors: {
+        list: () => Promise<unknown>;
+        get: (id: string) => Promise<unknown>;
+    };
+    readonly agents: {
+        list: () => Promise<unknown>;
+        get: (id: string) => Promise<unknown>;
+    };
+    readonly orders: {
+        list: (args?: Record<string, unknown>) => Promise<unknown>;
+    };
+}
+export declare function cursorMcpConfig(input: {
+    baseUrl: string;
+    accessToken: string;
+    serverName?: string;
+}): string;
+export declare function mcpRemoteStdioConfig(input: {
+    baseUrl: string;
+    accessToken: string;
+    serverName?: string;
+}): string;
+//# 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":"AAIA,MAAM,MAAM,sBAAsB,GAAG;IACjC,kEAAkE;IAClE,OAAO,EAAE,MAAM,CAAC;IAChB,2DAA2D;IAC3D,WAAW,EAAE,MAAM,CAAC;CACvB,CAAC;AAgBF,qBAAa,eAAe;IACxB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,SAAS,CAA8C;gBAEnD,OAAO,EAAE,sBAAsB;IAQ3C,IAAI,MAAM,IAAI,MAAM,CAEnB;IAEK,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAmBxB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAQtB,QAAQ,CAAC,CAAC,GAAG,OAAO,EACtB,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACnC,OAAO,CAAC,CAAC,CAAC;IAgBb,QAAQ,CAAC,UAAU;uBACA;YACX,KAAK,EAAE,MAAM,CAAC;YACd,QAAQ,CAAC,EAAE,MAAM,CAAC;YAClB,GAAG,CAAC,EAAE,MAAM,CAAC;YACb,IAAI,CAAC,EAAE,MAAM,CAAC;YACd,CAAC,CAAC,EAAE,MAAM,CAAC;YACX,MAAM,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,GAAG,KAAK,CAAC;SAC/C;;MAEH;IAEF,QAAQ,CAAC,IAAI;qBACI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;wBAEpB;YAAE,SAAS,EAAE,MAAM,CAAC;YAAC,KAAK,CAAC,EAAE,MAAM,CAAA;SAAE;MAEvD;IAEF,QAAQ,CAAC,OAAO;;kBAEF,MAAM;MAClB;IAEF,QAAQ,CAAC,MAAM;;kBAED,MAAM;MAClB;IAEF,QAAQ,CAAC,MAAM;sBACG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;MAEvC;CACL;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB,GAAG,MAAM,CAiBT;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE;IACxC,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB,GAAG,MAAM,CAkBT"}

package/dist/index.js

@@ -0,0 +1,118 @@
+import { Client } from "@modelcontextprotocol/sdk/client/index.js";
+import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";
+import { PACKAGE_VERSION } from "./version.js";
+function normalizeBaseUrl(baseUrl) {
+    return baseUrl.replace(/\/+$/, "");
+}
+function textFromToolContent(content) {
+    if (!content?.length)
+        return "";
+    return content
+        .filter((c) => c.type === "text" && typeof c.text === "string")
+        .map((c) => c.text)
+        .join("\n");
+}
+export class TarielMcpClient {
+    baseUrl;
+    accessToken;
+    client = null;
+    transport = null;
+    constructor(options) {
+        this.baseUrl = normalizeBaseUrl(options.baseUrl);
+        this.accessToken = options.accessToken.trim();
+        if (!this.accessToken) {
+            throw new Error("accessToken is required");
+        }
+    }
+    get mcpUrl() {
+        return `${this.baseUrl}/api/mcp`;
+    }
+    async connect() {
+        if (this.client)
+            return;
+        this.transport = new StreamableHTTPClientTransport(new URL(this.mcpUrl), {
+            requestInit: {
+                headers: {
+                    Authorization: `Bearer ${this.accessToken}`,
+                },
+            },
+        });
+        this.client = new Client({
+            name: "@tarielai/mcp-client",
+            version: PACKAGE_VERSION,
+        });
+        await this.client.connect(this.transport);
+    }
+    async close() {
+        if (this.client) {
+            await this.client.close();
+            this.client = null;
+        }
+        this.transport = null;
+    }
+    async callTool(name, args = {}) {
+        await this.connect();
+        const result = await this.client.callTool({ name, arguments: args });
+        const content = result.content;
+        if (result.isError) {
+            throw new Error(textFromToolContent(content) || `Tool ${name} failed`);
+        }
+        const text = textFromToolContent(content);
+        if (!text)
+            return undefined;
+        try {
+            return JSON.parse(text);
+        }
+        catch {
+            return text;
+        }
+    }
+    projection = {
+        export: (args) => this.callTool("tariel_projection_export", args),
+        credits: () => this.callTool("tariel_projection_credits"),
+    };
+    news = {
+        list: (args) => this.callTool("tariel_news_list", args),
+        article: (args) => this.callTool("tariel_news_article", args),
+    };
+    anchors = {
+        list: () => this.callTool("tariel_anchors_list"),
+        get: (id) => this.callTool("tariel_anchors_get", { id }),
+    };
+    agents = {
+        list: () => this.callTool("tariel_agents_list"),
+        get: (id) => this.callTool("tariel_agents_get", { id }),
+    };
+    orders = {
+        list: (args) => this.callTool("tariel_orders_list", args ?? {}),
+    };
+}
+export function cursorMcpConfig(input) {
+    const name = input.serverName ?? "tariel";
+    const url = `${normalizeBaseUrl(input.baseUrl)}/api/mcp`;
+    return JSON.stringify({
+        mcpServers: {
+            [name]: {
+                url,
+                headers: {
+                    Authorization: `Bearer ${input.accessToken}`,
+                },
+            },
+        },
+    }, null, 2);
+}
+export function mcpRemoteStdioConfig(input) {
+    const name = input.serverName ?? "tariel";
+    const url = `${normalizeBaseUrl(input.baseUrl)}/api/mcp`;
+    return JSON.stringify({
+        mcpServers: {
+            [name]: {
+                command: "npx",
+                args: ["-y", "mcp-remote", url],
+                env: {
+                    AUTHORIZATION: `Bearer ${input.accessToken}`,
+                },
+            },
+        },
+    }, null, 2);
+}

package/dist/index.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.test.d.ts.map

package/dist/index.test.d.ts.map

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

package/dist/index.test.js

@@ -0,0 +1,24 @@
+import { describe, expect, it } from "vitest";
+import { cursorMcpConfig, mcpRemoteStdioConfig } from "./index.js";
+describe("@tarielai/mcp-client config helpers", () => {
+    it("builds Cursor remote MCP config", () => {
+        const json = cursorMcpConfig({
+            baseUrl: "https://app.example.com/",
+            accessToken: "pf_live_test",
+            serverName: "tariel",
+        });
+        const parsed = JSON.parse(json);
+        expect(parsed.mcpServers.tariel.url).toBe("https://app.example.com/api/mcp");
+        expect(parsed.mcpServers.tariel.headers.Authorization).toBe("Bearer pf_live_test");
+    });
+    it("builds mcp-remote stdio bridge config", () => {
+        const json = mcpRemoteStdioConfig({
+            baseUrl: "https://app.example.com",
+            accessToken: "jwt-token",
+        });
+        const parsed = JSON.parse(json);
+        expect(parsed.mcpServers.tariel.command).toBe("npx");
+        expect(parsed.mcpServers.tariel.args[2]).toBe("https://app.example.com/api/mcp");
+        expect(parsed.mcpServers.tariel.env.AUTHORIZATION).toContain("jwt-token");
+    });
+});

package/dist/version.d.ts

@@ -0,0 +1,3 @@
+/** Generated by scripts/write-version.mjs — do not edit. */
+export declare const PACKAGE_VERSION = "0.1.0";
+//# sourceMappingURL=version.d.ts.map

package/dist/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,eAAO,MAAM,eAAe,UAAU,CAAC"}

package/dist/version.js

@@ -0,0 +1,2 @@
+/** Generated by scripts/write-version.mjs — do not edit. */
+export const PACKAGE_VERSION = "0.1.0";

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@tarielai/mcp-client",
+  "version": "0.1.0",
+  "description": "Typed MCP client for the Tariel API server",
+  "type": "module",
+  "license": "MIT",
+  "homepage": "https://www.tariel.ai",
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "prebuild": "node scripts/write-version.mjs",
+    "build": "tsc -p tsconfig.build.json",
+    "pretest": "node scripts/write-version.mjs",
+    "test": "vitest run",
+    "prepare": "npm run build"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.26.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.9.3",
+    "vitest": "^3.2.4"
+  }
+}