@carbon-copy/mcp 0.2.2 → 0.3.1

package/src/client.ts

@@ -1,206 +0,0 @@
-const BASE_URL =
-  process.env.CARBONCOPY_BASE_URL?.trim() || "https://www.carboncopy.inc";
-
-function buildQuery(
-  params: Record<string, string | number | undefined>,
-): string {
-  const qs = Object.entries(params)
-    .filter(([, v]) => v !== undefined)
-    .map(
-      ([k, v]) => `${encodeURIComponent(k)}=${encodeURIComponent(String(v))}`,
-    )
-    .join("&");
-  return qs ? `?${qs}` : "";
-}
-
-export class CarbonCopyClient {
-  private readonly apiKey: string;
-
-  constructor(apiKey: string) {
-    this.apiKey = apiKey;
-  }
-
-  private async request<T>(
-    method: string,
-    path: string,
-    body?: unknown,
-  ): Promise<T> {
-    const url = `${BASE_URL}${path}`;
-    const headers: Record<string, string> = {
-      Authorization: `Bearer ${this.apiKey}`,
-      "Content-Type": "application/json",
-    };
-
-    const res = await fetch(url, {
-      method,
-      headers,
-      body: body !== undefined ? JSON.stringify(body) : undefined,
-    });
-
-    if (!res.ok) {
-      const cloned = res.clone();
-      let errorBody: unknown;
-      try {
-        errorBody = await cloned.json();
-      } catch {
-        errorBody = await res.text();
-      }
-      throw new Error(
-        `Carbon Copy API error ${res.status} ${res.statusText}: ${JSON.stringify(errorBody)}`,
-      );
-    }
-
-    if (res.status === 204 || res.headers.get("content-length") === "0") {
-      return undefined as unknown as T;
-    }
-
-    const text = await res.text();
-    if (!text) return undefined as unknown as T;
-    return JSON.parse(text) as T;
-  }
-
-  // Portfolio
-  getPortfolio(): Promise<unknown> {
-    return this.request("GET", "/api/v1/portfolio");
-  }
-
-  getPortfolioHistory(params?: {
-    limit?: number;
-    cursor?: string;
-    since?: string;
-    until?: string;
-  }): Promise<unknown> {
-    const qs = buildQuery(params ?? {});
-    return this.request("GET", `/api/v1/portfolio/history${qs}`);
-  }
-
-  getPositions(params?: {
-    limit?: number;
-    cursor?: string;
-    since?: string;
-    until?: string;
-  }): Promise<unknown> {
-    const qs = buildQuery(params ?? {});
-    return this.request("GET", `/api/v1/portfolio/positions${qs}`);
-  }
-
-  // Traders
-  getTraders(): Promise<unknown> {
-    return this.request("GET", "/api/v1/portfolio/traders");
-  }
-
-  discoverTraders(params?: {
-    q?: string;
-    sortBy?: string;
-    minVolume?: number;
-    minRoi?: number;
-    minWinRate?: number;
-    limit?: number;
-  }): Promise<unknown> {
-    const qs = buildQuery(params ?? {});
-    return this.request("GET", `/api/v1/traders${qs}`);
-  }
-
-  followTrader(body: {
-    wallet: string;
-    copyPercentage: number;
-    maxCopyAmount?: number;
-    notificationsEnabled?: boolean;
-  }): Promise<unknown> {
-    const { wallet, ...rest } = body;
-    return this.request("POST", "/api/v1/portfolio/traders", {
-      walletAddress: wallet,
-      ...rest,
-    });
-  }
-
-  getTrader(wallet: string): Promise<unknown> {
-    return this.request(
-      "GET",
-      `/api/v1/portfolio/traders/${encodeURIComponent(wallet)}`,
-    );
-  }
-
-  getTraderPerformance(wallet: string): Promise<unknown> {
-    return this.request(
-      "GET",
-      `/api/v1/traders/${encodeURIComponent(wallet)}/performance`,
-    );
-  }
-
-  updateTrader(
-    wallet: string,
-    body: {
-      copyPercentage?: number;
-      maxCopyAmount?: number;
-      notificationsEnabled?: boolean;
-      copyTradingEnabled?: boolean;
-    },
-  ): Promise<unknown> {
-    return this.request(
-      "PATCH",
-      `/api/v1/portfolio/traders/${encodeURIComponent(wallet)}`,
-      body,
-    );
-  }
-
-  batchUpdateTraders(
-    updates: Array<{
-      walletAddress: string;
-      copyPercentage?: number;
-      maxCopyAmount?: number;
-      notificationsEnabled?: boolean;
-      copyTradingEnabled?: boolean;
-    }>,
-  ): Promise<unknown> {
-    return this.request("PATCH", "/api/v1/portfolio/traders/batch", {
-      updates,
-    });
-  }
-
-  unfollowTrader(wallet: string): Promise<unknown> {
-    return this.request(
-      "DELETE",
-      `/api/v1/portfolio/traders/${encodeURIComponent(wallet)}`,
-    );
-  }
-
-  pauseTrader(wallet: string): Promise<unknown> {
-    return this.request(
-      "POST",
-      `/api/v1/portfolio/traders/${encodeURIComponent(wallet)}/pause`,
-    );
-  }
-
-  resumeTrader(wallet: string): Promise<unknown> {
-    return this.request(
-      "POST",
-      `/api/v1/portfolio/traders/${encodeURIComponent(wallet)}/resume`,
-    );
-  }
-
-  // Orders
-  getOrders(params?: {
-    status?: string;
-    limit?: number;
-    cursor?: string;
-    since?: string;
-    until?: string;
-  }): Promise<unknown> {
-    const qs = buildQuery(params ?? {});
-    return this.request("GET", `/api/v1/orders${qs}`);
-  }
-
-  getOrder(id: string): Promise<unknown> {
-    return this.request("GET", `/api/v1/orders/${encodeURIComponent(id)}`);
-  }
-
-  // Account
-  getAccount(): Promise<unknown> {
-    return this.request("GET", "/api/v1/account");
-  }
-
-  health(): Promise<unknown> {
-    return this.request("GET", "/api/v1/health");
-  }
-}

package/src/index.ts

@@ -1,41 +0,0 @@
-#!/usr/bin/env node
-
-import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import { CarbonCopyClient } from "./client.js";
-import { registerPortfolioTools } from "./tools/portfolio.js";
-import { registerTraderTools } from "./tools/traders.js";
-import { registerOrderTools } from "./tools/orders.js";
-import { registerAccountTools } from "./tools/account.js";
-import { registerPortfolioResources } from "./resources/portfolio.js";
-import { registerTraderResources } from "./resources/traders.js";
-
-const apiKey = process.env.CARBONCOPY_API_KEY;
-if (!apiKey) {
-  console.error(
-    "Error: CARBONCOPY_API_KEY environment variable is required.\n" +
-      "Set it to your Carbon Copy API key (format: cc_<64 hex chars>)."
-  );
-  process.exit(1);
-}
-
-const client = new CarbonCopyClient(apiKey);
-
-const server = new McpServer({
-  name: "carboncopy",
-  version: "0.1.0",
-});
-
-// Register tools
-registerPortfolioTools(server, client);
-registerTraderTools(server, client);
-registerOrderTools(server, client);
-registerAccountTools(server, client);
-
-// Register resources
-registerPortfolioResources(server, client);
-registerTraderResources(server, client);
-
-// Connect via stdio transport
-const transport = new StdioServerTransport();
-await server.connect(transport);

package/src/resources/portfolio.ts

@@ -1,30 +0,0 @@
-import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-import { CarbonCopyClient } from "../client.js";
-
-export function registerPortfolioResources(
-  server: McpServer,
-  client: CarbonCopyClient
-): void {
-  server.registerResource(
-    "portfolio",
-    "carboncopy://portfolio",
-    {
-      title: "Carbon Copy Portfolio",
-      description:
-        "Current portfolio snapshot including total value, P&L, and allocation.",
-      mimeType: "application/json",
-    },
-    async () => {
-      const data = await client.getPortfolio();
-      return {
-        contents: [
-          {
-            uri: "carboncopy://portfolio",
-            mimeType: "application/json",
-            text: JSON.stringify(data ?? {}, null, 2),
-          },
-        ],
-      };
-    }
-  );
-}

package/src/resources/traders.ts

@@ -1,29 +0,0 @@
-import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-import { CarbonCopyClient } from "../client.js";
-
-export function registerTraderResources(
-  server: McpServer,
-  client: CarbonCopyClient
-): void {
-  server.registerResource(
-    "traders",
-    "carboncopy://traders",
-    {
-      title: "Carbon Copy Traders",
-      description: "List of all traders you are currently following.",
-      mimeType: "application/json",
-    },
-    async () => {
-      const data = await client.getTraders();
-      return {
-        contents: [
-          {
-            uri: "carboncopy://traders",
-            mimeType: "application/json",
-            text: JSON.stringify(data ?? [], null, 2),
-          },
-        ],
-      };
-    }
-  );
-}

package/src/tools/account.ts

@@ -1,48 +0,0 @@
-import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-import { z } from "zod";
-import { CarbonCopyClient } from "../client.js";
-
-export function registerAccountTools(
-  server: McpServer,
-  client: CarbonCopyClient
-): void {
-  server.registerTool(
-    "get_account",
-    {
-      title: "Get Account",
-      description:
-        "Retrieve your Carbon Copy account details including wallet address, balance, and settings.",
-      inputSchema: z.object({}),
-      annotations: {
-        readOnlyHint: true,
-        openWorldHint: false,
-      },
-    },
-    async () => {
-      const data = await client.getAccount();
-      return {
-        content: [{ type: "text", text: JSON.stringify(data ?? { success: true }, null, 2) }],
-      };
-    }
-  );
-
-  server.registerTool(
-    "health",
-    {
-      title: "Health Check",
-      description:
-        "Check the health and availability of the Carbon Copy API.",
-      inputSchema: z.object({}),
-      annotations: {
-        readOnlyHint: true,
-        openWorldHint: false,
-      },
-    },
-    async () => {
-      const data = await client.health();
-      return {
-        content: [{ type: "text", text: JSON.stringify(data ?? { success: true }, null, 2) }],
-      };
-    }
-  );
-}

package/src/tools/orders.ts

@@ -1,88 +0,0 @@
-import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-import { z } from "zod";
-import type { CarbonCopyClient } from "../client.js";
-
-export function registerOrderTools(
-  server: McpServer,
-  client: CarbonCopyClient,
-): void {
-  server.registerTool(
-    "list_orders",
-    {
-      title: "List Orders",
-      description:
-        "Retrieve a list of copy-trade orders with optional status filter, pagination, and date range.",
-      inputSchema: z.object({
-        status: z
-          .string()
-          .optional()
-          .describe(
-            "Filter by order status: 'pending', 'filled', 'failed', or 'cancelled'.",
-          ),
-        limit: z
-          .number()
-          .int()
-          .positive()
-          .optional()
-          .describe("Maximum number of records to return."),
-        cursor: z
-          .string()
-          .optional()
-          .describe("Pagination cursor from a previous response."),
-        since: z
-          .string()
-          .optional()
-          .describe(
-            "ISO 8601 timestamp — only return records after this time.",
-          ),
-        until: z
-          .string()
-          .optional()
-          .describe(
-            "ISO 8601 timestamp — only return records before this time.",
-          ),
-      }),
-      annotations: {
-        readOnlyHint: true,
-        openWorldHint: false,
-      },
-    },
-    async (params) => {
-      const data = await client.getOrders(params);
-      return {
-        content: [
-          {
-            type: "text",
-            text: JSON.stringify(data ?? { success: true }, null, 2),
-          },
-        ],
-      };
-    },
-  );
-
-  server.registerTool(
-    "get_order",
-    {
-      title: "Get Order",
-      description: "Retrieve details about a specific copy-trade order by ID.",
-      inputSchema: z.object({
-        id: z.string().describe("The order ID to retrieve."),
-      }),
-      annotations: {
-        readOnlyHint: true,
-        openWorldHint: false,
-      },
-    },
-    async ({ id }) => {
-      const data = await client.getOrder(id);
-      return {
-        content: [
-          {
-            type: "text",
-            text: JSON.stringify(data ?? { success: true }, null, 2),
-          },
-        ],
-      };
-    },
-  );
-}

package/src/tools/portfolio.ts

@@ -1,106 +0,0 @@
-import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-import { z } from "zod";
-import { CarbonCopyClient } from "../client.js";
-
-export function registerPortfolioTools(
-  server: McpServer,
-  client: CarbonCopyClient
-): void {
-  server.registerTool(
-    "get_portfolio",
-    {
-      title: "Get Portfolio",
-      description:
-        "Retrieve the current portfolio summary including total value, P&L, and allocation.",
-      inputSchema: z.object({}),
-      annotations: {
-        readOnlyHint: true,
-        openWorldHint: false,
-      },
-    },
-    async () => {
-      const data = await client.getPortfolio();
-      return {
-        content: [{ type: "text", text: JSON.stringify(data ?? { success: true }, null, 2) }],
-      };
-    }
-  );
-
-  server.registerTool(
-    "get_portfolio_history",
-    {
-      title: "Get Portfolio History",
-      description:
-        "Retrieve paginated copy-trade history with optional date filtering.",
-      inputSchema: z.object({
-        limit: z
-          .number()
-          .int()
-          .positive()
-          .optional()
-          .describe("Maximum number of records to return."),
-        cursor: z
-          .string()
-          .optional()
-          .describe("Pagination cursor from a previous response."),
-        since: z
-          .string()
-          .optional()
-          .describe("ISO 8601 timestamp — only return records after this time."),
-        until: z
-          .string()
-          .optional()
-          .describe("ISO 8601 timestamp — only return records before this time."),
-      }),
-      annotations: {
-        readOnlyHint: true,
-        openWorldHint: false,
-      },
-    },
-    async (params) => {
-      const data = await client.getPortfolioHistory(params);
-      return {
-        content: [{ type: "text", text: JSON.stringify(data ?? { success: true }, null, 2) }],
-      };
-    }
-  );
-
-  server.registerTool(
-    "get_positions",
-    {
-      title: "Get Positions",
-      description:
-        "Retrieve current or historical portfolio positions with optional pagination and date filtering.",
-      inputSchema: z.object({
-        limit: z
-          .number()
-          .int()
-          .positive()
-          .optional()
-          .describe("Maximum number of records to return."),
-        cursor: z
-          .string()
-          .optional()
-          .describe("Pagination cursor from a previous response."),
-        since: z
-          .string()
-          .optional()
-          .describe("ISO 8601 timestamp — only return records after this time."),
-        until: z
-          .string()
-          .optional()
-          .describe("ISO 8601 timestamp — only return records before this time."),
-      }),
-      annotations: {
-        readOnlyHint: true,
-        openWorldHint: false,
-      },
-    },
-    async (params) => {
-      const data = await client.getPositions(params);
-      return {
-        content: [{ type: "text", text: JSON.stringify(data ?? { success: true }, null, 2) }],
-      };
-    }
-  );
-}