@carbonstopper/agent-mcp 0.1.2

package/AGENTS.md

@@ -0,0 +1,40 @@
+# AGENTS.md
+
+## Purpose
+
+This is a stdio MCP server for Carbonstop server-side Agent usage. It wraps Java internal Agent APIs through gateway service prefixes:
+
+- `/ai/agent/internal/platform/**`
+- `/footprint3/agent/internal/skills/**`
+
+## Authentication
+
+Do not use Carbon Cloud open platform API keys here.
+
+The MCP process reads:
+
+- `CARBONSTOP_AGENT_BASE_URL`
+- `CARBONSTOP_AGENT_INTERNAL_KEY`
+- `CARBONSTOP_TIMEOUT`
+
+Each tool call must include `sessionId`. The HTTP client forwards it in both `X-Agent-Session-Id` and the JSON body.
+
+## Architecture
+
+```text
+src/index.ts    MCP server entry and tool registration
+src/tools.ts    Zod schemas, descriptions, route mapping, body builder
+src/client.ts   HTTP client with retry and Agent internal headers
+src/config.ts   environment loading
+src/apipath.ts  Java endpoint paths
+src/version.ts  version info
+```
+
+## Tool Families
+
+- Platform context and memory: `session_context`, `project_memory_get`, `project_memory_patch`, `project_memory_compress`
+- Product carbon skills: `modeling_preview`, `modeling_execute`, `modeling_update`, `modeling_detail`
+- Report skills: `report_generate`, `report_detail`
+- Support skills: `analysis_run`, `factor_search`, `knowledge_search`
+
+Write or high-risk tools require `idempotencyKey`.

package/README.md

@@ -0,0 +1,162 @@
+# carbonstop-agent-mcp
+
+MCP (Model Context Protocol) server for Carbonstop Agent internal skill APIs.
+
+This package is for server-side Agent scenarios. It wraps Carbonstop Java internal Agent APIs and forwards the Agent session identity to the gateway.
+
+## Install
+
+This Agent package is published as `@carbonstopper/agent-mcp`; the existing `@carbonstopper/mcp` package remains the Carbon Cloud open-platform-key version.
+
+```bash
+npm install -g @carbonstopper/agent-mcp
+```
+
+Or run directly:
+
+```bash
+npx @carbonstopper/agent-mcp
+```
+
+## Quick Start
+
+1. Configure the Agent internal key:
+
+```bash
+export CARBONSTOP_AGENT_INTERNAL_KEY="your-agent-internal-key"
+```
+
+2. Start the MCP server:
+
+```bash
+npx @carbonstopper/agent-mcp
+```
+
+The npm release includes the default gateway base URL injected during the release build. For local debugging or environment override, set:
+
+```bash
+export CARBONSTOP_AGENT_BASE_URL="https://your-gateway-host"
+```
+
+`CARBONSTOP_BASE_URL` is also accepted as a compatibility fallback.
+
+## MCP Client Config
+
+### Claude Code / Claude Desktop
+
+```json
+{
+  "mcpServers": {
+    "carbonstop-agent": {
+      "command": "npx",
+      "args": ["@carbonstopper/agent-mcp"],
+      "env": {
+        "CARBONSTOP_AGENT_INTERNAL_KEY": "your-agent-internal-key"
+      }
+    }
+  }
+}
+```
+
+### Cursor
+
+```json
+{
+  "mcpServers": {
+    "carbonstop-agent": {
+      "command": "npx",
+      "args": ["@carbonstopper/agent-mcp"],
+      "env": {
+        "CARBONSTOP_AGENT_INTERNAL_KEY": "your-agent-internal-key"
+      }
+    }
+  }
+}
+```
+
+For local debugging against a non-default gateway, add:
+
+```json
+"CARBONSTOP_AGENT_BASE_URL": "http://localhost:8080"
+```
+
+## Authentication
+
+- The MCP server does not use Carbon Cloud open platform API keys.
+- Each tool call must include `sessionId`; the Agent should pass the session id received from the server-side Agent invocation.
+- The MCP server forwards:
+  - `X-Agent-Internal-Key: ${CARBONSTOP_AGENT_INTERNAL_KEY}`
+  - `X-Agent-Session-Id: ${sessionId}`
+- The same `sessionId` is kept in the JSON body for audit, idempotency, trace, and business context.
+
+## Available Tools
+
+| Tool | Description |
+| --- | --- |
+| `session_context` | Resolve session ownership and business context. |
+| `project_memory_get` | Read project memory. |
+| `project_memory_patch` | Patch project memory. Requires `idempotencyKey`. |
+| `project_memory_compress` | Save compressed project memory. Requires `idempotencyKey`. |
+| `modeling_preview` | Preview product carbon AI modeling. |
+| `modeling_execute` | Execute product carbon AI modeling. Requires `idempotencyKey`. |
+| `modeling_update` | Update an existing product carbon model. Requires `accountId` and `idempotencyKey`. |
+| `modeling_detail` | Get product carbon model details. |
+| `report_generate` | Generate a product carbon report. Requires `idempotencyKey`. |
+| `report_detail` | Get product carbon report detail and latest report URL. |
+| `analysis_run` | Run product carbon analysis. |
+| `factor_search` | Search and match carbon emission factors. |
+| `knowledge_search` | Search carbon knowledge. |
+
+## Tool Request Shape
+
+Most tools forward the unified Agent skill request:
+
+```json
+{
+  "sessionId": "agent_xxx",
+  "projectId": 1001,
+  "accountId": 2001,
+  "modelId": null,
+  "reportId": null,
+  "idempotencyKey": "agent_xxx_modeling_execute_v1",
+  "confirmed": true,
+  "pendingActionId": null,
+  "input": {}
+}
+```
+
+Write or high-risk tools require `idempotencyKey`, especially:
+
+- `modeling_execute`
+- `modeling_update`
+- `report_generate`
+- `project_memory_patch`
+- `project_memory_compress`
+
+## API Routes
+
+Platform APIs are called through the `ai` gateway prefix:
+
+```text
+/ai/agent/internal/platform/**
+```
+
+Product carbon skill APIs are called through the `footprint3` gateway prefix:
+
+```text
+/footprint3/agent/internal/skills/**
+```
+
+## Release Build
+
+`RELEASE_BASE_URL_ENCODED` is a repository secret used by the GitHub Actions build to inject the default gateway base URL. It is not required in MCP client config.
+
+Runtime environment variables still take priority:
+
+```text
+CARBONSTOP_AGENT_BASE_URL > CARBONSTOP_BASE_URL > release build URL
+```
+
+## License
+
+MIT

package/dist/apipath.d.ts

@@ -0,0 +1,13 @@
+export declare const SessionContext: () => string;
+export declare const ProjectMemoryGet: () => string;
+export declare const ProjectMemoryPatch: () => string;
+export declare const ProjectMemoryCompress: () => string;
+export declare const ModelingPreview: () => string;
+export declare const ModelingExecute: () => string;
+export declare const ModelingUpdate: () => string;
+export declare const ModelingDetail: () => string;
+export declare const ReportGenerate: () => string;
+export declare const ReportDetail: () => string;
+export declare const AnalysisRun: () => string;
+export declare const FactorSearch: () => string;
+export declare const KnowledgeSearch: () => string;

package/dist/apipath.js

@@ -0,0 +1,16 @@
+const aiPrefix = "/ai";
+const footprint3Prefix = "/footprint3";
+export const SessionContext = () => `${aiPrefix}/agent/internal/platform/sessionContext`;
+export const ProjectMemoryGet = () => `${aiPrefix}/agent/internal/platform/project-memory/get`;
+export const ProjectMemoryPatch = () => `${aiPrefix}/agent/internal/platform/project-memory/patch`;
+export const ProjectMemoryCompress = () => `${aiPrefix}/agent/internal/platform/project-memory/compress`;
+export const ModelingPreview = () => `${footprint3Prefix}/agent/internal/skills/modeling/preview`;
+export const ModelingExecute = () => `${footprint3Prefix}/agent/internal/skills/modeling/execute`;
+export const ModelingUpdate = () => `${footprint3Prefix}/agent/internal/skills/modeling/update`;
+export const ModelingDetail = () => `${footprint3Prefix}/agent/internal/skills/modeling/detail`;
+export const ReportGenerate = () => `${footprint3Prefix}/agent/internal/skills/report/generate`;
+export const ReportDetail = () => `${footprint3Prefix}/agent/internal/skills/report/detail`;
+export const AnalysisRun = () => `${footprint3Prefix}/agent/internal/skills/analysis/run`;
+export const FactorSearch = () => `${footprint3Prefix}/agent/internal/skills/factor/search`;
+export const KnowledgeSearch = () => `${footprint3Prefix}/agent/internal/skills/knowledge/search`;
+//# sourceMappingURL=apipath.js.map

package/dist/apipath.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"apipath.js","sourceRoot":"","sources":["../src/apipath.ts"],"names":[],"mappings":"AAAA,MAAM,QAAQ,GAAG,KAAK,CAAC;AACvB,MAAM,gBAAgB,GAAG,aAAa,CAAC;AAEvC,MAAM,CAAC,MAAM,cAAc,GAAG,GAAG,EAAE,CAAC,GAAG,QAAQ,yCAAyC,CAAC;AACzF,MAAM,CAAC,MAAM,gBAAgB,GAAG,GAAG,EAAE,CAAC,GAAG,QAAQ,6CAA6C,CAAC;AAC/F,MAAM,CAAC,MAAM,kBAAkB,GAAG,GAAG,EAAE,CAAC,GAAG,QAAQ,+CAA+C,CAAC;AACnG,MAAM,CAAC,MAAM,qBAAqB,GAAG,GAAG,EAAE,CAAC,GAAG,QAAQ,kDAAkD,CAAC;AAEzG,MAAM,CAAC,MAAM,eAAe,GAAG,GAAG,EAAE,CAAC,GAAG,gBAAgB,yCAAyC,CAAC;AAClG,MAAM,CAAC,MAAM,eAAe,GAAG,GAAG,EAAE,CAAC,GAAG,gBAAgB,yCAAyC,CAAC;AAClG,MAAM,CAAC,MAAM,cAAc,GAAG,GAAG,EAAE,CAAC,GAAG,gBAAgB,wCAAwC,CAAC;AAChG,MAAM,CAAC,MAAM,cAAc,GAAG,GAAG,EAAE,CAAC,GAAG,gBAAgB,wCAAwC,CAAC;AAChG,MAAM,CAAC,MAAM,cAAc,GAAG,GAAG,EAAE,CAAC,GAAG,gBAAgB,wCAAwC,CAAC;AAChG,MAAM,CAAC,MAAM,YAAY,GAAG,GAAG,EAAE,CAAC,GAAG,gBAAgB,sCAAsC,CAAC;AAC5F,MAAM,CAAC,MAAM,WAAW,GAAG,GAAG,EAAE,CAAC,GAAG,gBAAgB,qCAAqC,CAAC;AAC1F,MAAM,CAAC,MAAM,YAAY,GAAG,GAAG,EAAE,CAAC,GAAG,gBAAgB,sCAAsC,CAAC;AAC5F,MAAM,CAAC,MAAM,eAAe,GAAG,GAAG,EAAE,CAAC,GAAG,gBAAgB,yCAAyC,CAAC"}

package/dist/baseurl.d.ts

@@ -0,0 +1 @@
+export declare const encodedBaseURL: string;

package/dist/baseurl.js

@@ -0,0 +1,3 @@
+// Auto-generated at build time. Do not commit.
+export const encodedBaseURL = "https://gateway-base-test.carbonstop.com";
+//# sourceMappingURL=baseurl.js.map

package/dist/baseurl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"baseurl.js","sourceRoot":"","sources":["../src/baseurl.ts"],"names":[],"mappings":"AAAA,+CAA+C;AAC/C,MAAM,CAAC,MAAM,cAAc,GAAW,0CAA0C,CAAC"}

package/dist/client.d.ts

@@ -0,0 +1,14 @@
+import { Config } from "./config.js";
+export declare class Client {
+    private config;
+    constructor(config: Config);
+    private request;
+    get(path: string, sessionId: string, query?: Record<string, string>): Promise<{
+        status: number;
+        body: string;
+    }>;
+    post(path: string, sessionId: string, jsonBody?: unknown): Promise<{
+        status: number;
+        body: string;
+    }>;
+}

package/dist/client.js

@@ -0,0 +1,62 @@
+const userAgent = "carbonstop-agent-mcp/0.1.0";
+const maxRetries = 3;
+const baseBackoff = 1000;
+export class Client {
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    async request(method, path, sessionId, body, query) {
+        if (!path.startsWith("/"))
+            path = "/" + path;
+        const u = new URL(this.config.baseURL + path);
+        if (query) {
+            for (const [k, v] of Object.entries(query)) {
+                if (v)
+                    u.searchParams.set(k, v);
+            }
+        }
+        let lastErr = null;
+        for (let attempt = 0; attempt <= maxRetries; attempt++) {
+            if (attempt > 0) {
+                const backoff = Math.pow(2, attempt - 1) * baseBackoff;
+                await new Promise((r) => setTimeout(r, backoff));
+            }
+            try {
+                const headers = {
+                    "X-Agent-Internal-Key": this.config.agentInternalKey,
+                    "X-Agent-Session-Id": sessionId,
+                    Accept: "application/json",
+                    "User-Agent": userAgent,
+                };
+                if (body) {
+                    headers["Content-Type"] = "application/json;charset=utf-8";
+                }
+                const resp = await fetch(u.toString(), {
+                    method,
+                    headers,
+                    body,
+                    signal: AbortSignal.timeout(this.config.timeout * 1000),
+                });
+                const text = await resp.text();
+                if (resp.status === 429 || resp.status >= 500) {
+                    lastErr = new Error(`retryable server error: ${resp.status}`);
+                    continue;
+                }
+                return { status: resp.status, body: text };
+            }
+            catch (e) {
+                lastErr = e;
+                continue;
+            }
+        }
+        throw new Error(`request failed after ${maxRetries + 1} retries: ${lastErr?.message}`);
+    }
+    async get(path, sessionId, query) {
+        return this.request("GET", path, sessionId, undefined, query);
+    }
+    async post(path, sessionId, jsonBody) {
+        return this.request("POST", path, sessionId, JSON.stringify(jsonBody));
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,6 @@
+export interface Config {
+    baseURL: string;
+    agentInternalKey: string;
+    timeout: number;
+}
+export declare function load(): Config;

package/dist/config.js

@@ -0,0 +1,16 @@
+import { getBaseURL } from "./version.js";
+export function load() {
+    const baseURL = process.env.CARBONSTOP_AGENT_BASE_URL ||
+        process.env.CARBONSTOP_BASE_URL ||
+        getBaseURL() ||
+        "";
+    const agentInternalKey = process.env.CARBONSTOP_AGENT_INTERNAL_KEY || "";
+    const parsedTimeout = parseInt(process.env.CARBONSTOP_TIMEOUT || "60", 10);
+    const timeout = Number.isFinite(parsedTimeout) && parsedTimeout > 0 ? parsedTimeout : 60;
+    return {
+        baseURL: baseURL.replace(/\/$/, ""),
+        agentInternalKey,
+        timeout,
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAQ1C,MAAM,UAAU,IAAI;IAClB,MAAM,OAAO,GACX,OAAO,CAAC,GAAG,CAAC,yBAAyB;QACrC,OAAO,CAAC,GAAG,CAAC,mBAAmB;QAC/B,UAAU,EAAE;QACZ,EAAE,CAAC;IACL,MAAM,gBAAgB,GAAG,OAAO,CAAC,GAAG,CAAC,6BAA6B,IAAI,EAAE,CAAC;IACzE,MAAM,aAAa,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,IAAI,EAAE,EAAE,CAAC,CAAC;IAC3E,MAAM,OAAO,GAAG,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAC,IAAI,aAAa,GAAG,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC;IAEzF,OAAO;QACL,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC;QACnC,gBAAgB;QAChB,OAAO;KACR,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

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

package/dist/index.js

@@ -0,0 +1,61 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { load } from "./config.js";
+import { Client } from "./client.js";
+import { schemas, descriptions, toolRoutes, buildBody, getSessionId } from "./tools.js";
+import { Version } from "./version.js";
+const config = load();
+if (!config.baseURL) {
+    console.error("[carbonstop-agent-mcp] CARBONSTOP_AGENT_BASE_URL is required");
+    process.exit(2);
+}
+if (!config.agentInternalKey) {
+    console.error("[carbonstop-agent-mcp] CARBONSTOP_AGENT_INTERNAL_KEY is required");
+    process.exit(2);
+}
+const server = new McpServer({
+    name: "carbonstop-agent-mcp",
+    version: Version,
+});
+const client = new Client(config);
+function textContent(text) {
+    return { content: [{ type: "text", text }] };
+}
+function errorContent(text) {
+    return { content: [{ type: "text", text }], isError: true };
+}
+for (const [name, schema] of Object.entries(schemas)) {
+    if (!schema)
+        continue;
+    server.registerTool(name, {
+        description: descriptions[name] || "",
+        inputSchema: schema,
+    }, async (args) => {
+        const route = toolRoutes[name];
+        if (!route) {
+            return errorContent(`Unknown tool: ${name}`);
+        }
+        try {
+            const sessionId = getSessionId(args);
+            const body = buildBody(route, args);
+            const result = await client.post(route.path, sessionId, body);
+            if (result.status < 200 || result.status >= 300) {
+                return errorContent(`HTTP ${result.status}\n${result.body}`);
+            }
+            try {
+                const parsed = JSON.parse(result.body);
+                return textContent(JSON.stringify(parsed, null, 2));
+            }
+            catch {
+                return textContent(result.body);
+            }
+        }
+        catch (err) {
+            return errorContent(`Error: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    });
+}
+const transport = new StdioServerTransport();
+await server.connect(transport);
+//# 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/tools.d.ts

@@ -0,0 +1,12 @@
+import { z } from "zod";
+export declare const schemas: Record<string, z.ZodObject<any> | undefined>;
+export declare const descriptions: Record<string, string>;
+export type BodyKind = "agentSkill" | "sessionContext";
+export interface ToolRoute {
+    method: "POST";
+    path: string;
+    bodyKind: BodyKind;
+}
+export declare const toolRoutes: Record<string, ToolRoute>;
+export declare function buildBody(route: ToolRoute, args: Record<string, unknown>): Record<string, unknown>;
+export declare function getSessionId(args: Record<string, unknown>): string;

package/dist/tools.js

@@ -0,0 +1,238 @@
+import { z } from "zod";
+import * as apipath from "./apipath.js";
+const jsonObject = z.record(z.string(), z.unknown());
+const sessionId = z
+    .string()
+    .min(1)
+    .describe("Agent session id. The caller must pass the sessionId received from the server-side Agent invocation.");
+const idempotencyKey = z
+    .string()
+    .min(1)
+    .describe("Idempotency key for write or high-risk skills. Reuse the same key only for retrying the same action.");
+const traceFields = {
+    messageId: z.string().optional().describe("Agent message id for grouping multiple skill nodes in one turn."),
+    traceId: z.string().optional().describe("Agent trace id for runtime trace aggregation."),
+    taskId: z.string().optional().describe("Agent task id, for example LangGraph run id."),
+};
+const commonSkillFields = {
+    sessionId,
+    projectId: z.number().optional().describe("Agent project id"),
+    ...traceFields,
+    accountId: z.number().optional().describe("Product carbon account id"),
+    modelId: z.number().optional().describe("Reserved model id"),
+    reportId: z.number().optional().describe("Report id"),
+    idempotencyKey: z.string().optional().describe("Required for write or high-risk skills"),
+    confirmed: z.boolean().optional().describe("Whether the user has confirmed a high-risk or high-cost action"),
+    pendingActionId: z.string().optional().describe("Pending action id returned by a confirmation response"),
+};
+const modelingInput = z.object({
+    content: z.string().optional().describe("Product description for AI modeling. Required by modeling_execute."),
+    message: z.string().optional().describe("Supplemental modeling information from the user or Agent."),
+    productName: z.string().optional().describe("Product name or short title."),
+    scope: z.union([z.number(), z.string()]).optional().describe("Lifecycle scope. Common values: 0 for partial lifecycle, 1 for full lifecycle."),
+    scopeValue: z.string().optional().describe("Lifecycle stage selection for partial lifecycle, for example 0,1,2."),
+    factorScope: z.number().optional().describe("Factor preference. Common values: 1 Ecoinvent, 2 domestic factors, 3 any source."),
+    userKeys: z.array(z.string()).optional().describe("User-selected custom factor keys."),
+    signKeys: z.array(z.string()).optional().describe("Marked factor keys."),
+}).catchall(z.unknown());
+const modelingExecuteInput = modelingInput.extend({
+    content: z.string().min(1).describe("Product description for AI modeling. Required by modeling_execute."),
+    message: z.string().optional().describe("Supplemental modeling information from the user or Agent."),
+});
+const modelUpdateInput = z.object({
+    accountId: z.number().optional().describe("Product carbon account id. Top-level accountId is preferred."),
+    userContent: z.string().optional().describe("Natural language update instruction, for example changing transport distance."),
+    message: z.string().optional().describe("Supplemental update information from the user or Agent."),
+}).catchall(z.unknown());
+const reportGenerateInput = z.object({
+    accountId: z.number().optional().describe("Product carbon account id. Top-level accountId is preferred."),
+    reportName: z.string().optional().describe("Report name to generate."),
+    standard: z.string().optional().describe("Report standard, for example ISO 14067."),
+    message: z.string().optional().describe("Supplemental report generation instruction from the user or Agent."),
+}).catchall(z.unknown());
+const analysisInput = z.object({
+    analysisType: z.string().describe("Analysis type, for example hotspot."),
+    message: z.string().optional().describe("Supplemental analysis instruction from the user or Agent."),
+}).catchall(z.unknown());
+const factorSearchInput = z.object({
+    query: z.string().min(1).describe("Factor search keyword, for example PET granules or electricity."),
+    unitName: z.string().optional().describe("Preferred unit name, for example kg or kWh."),
+    message: z.string().optional().describe("Supplemental factor matching context from the user or Agent."),
+}).catchall(z.unknown());
+const knowledgeSearchInput = z.object({
+    query: z.string().min(1).describe("Knowledge search question or keyword."),
+    message: z.string().optional().describe("Supplemental knowledge search context from the user or Agent."),
+}).catchall(z.unknown());
+export const schemas = {
+    session_context: z.object({
+        sessionId,
+    }),
+    project_memory_get: z.object({
+        sessionId,
+        projectId: z.number().optional(),
+        ...traceFields,
+        input: jsonObject.optional(),
+    }),
+    project_memory_patch: z.object({
+        sessionId,
+        projectId: z.number().optional(),
+        ...traceFields,
+        idempotencyKey,
+        input: jsonObject.describe("Memory patch payload"),
+    }),
+    project_memory_compress: z.object({
+        sessionId,
+        projectId: z.number().optional(),
+        ...traceFields,
+        idempotencyKey,
+        input: jsonObject.describe("Compressed memory payload"),
+    }),
+    modeling_preview: z.object({
+        ...commonSkillFields,
+        input: modelingInput,
+    }),
+    modeling_execute: z.object({
+        ...commonSkillFields,
+        idempotencyKey,
+        input: modelingExecuteInput,
+    }),
+    modeling_update: z.object({
+        ...commonSkillFields,
+        accountId: z.number().describe("Product carbon account id"),
+        idempotencyKey,
+        input: modelUpdateInput,
+    }),
+    modeling_detail: z.object({
+        sessionId,
+        projectId: z.number().optional(),
+        ...traceFields,
+        accountId: z.number().describe("Product carbon account id"),
+        input: jsonObject.optional(),
+    }),
+    report_generate: z.object({
+        ...commonSkillFields,
+        idempotencyKey,
+        input: reportGenerateInput.optional(),
+    }),
+    report_detail: z.object({
+        sessionId,
+        projectId: z.number().optional(),
+        ...traceFields,
+        reportId: z.number().describe("Report id"),
+        input: jsonObject.optional(),
+    }),
+    analysis_run: z.object({
+        ...commonSkillFields,
+        accountId: z.number().describe("Product carbon account id"),
+        input: analysisInput,
+    }),
+    factor_search: z.object({
+        sessionId,
+        projectId: z.number().optional(),
+        ...traceFields,
+        accountId: z.number().optional(),
+        input: factorSearchInput,
+    }),
+    knowledge_search: z.object({
+        sessionId,
+        projectId: z.number().optional(),
+        ...traceFields,
+        input: knowledgeSearchInput,
+    }),
+};
+export const descriptions = {
+    session_context: "Resolve session ownership and business context for an Agent session.",
+    project_memory_get: "Read project memory for the Agent session or project.",
+    project_memory_patch: "Patch project memory. Requires idempotencyKey.",
+    project_memory_compress: "Save compressed project memory. Requires idempotencyKey.",
+    modeling_preview: "Preview product carbon AI modeling before user confirmation.",
+    modeling_execute: "Execute product carbon AI modeling after confirmation. Requires idempotencyKey and input.content.",
+    modeling_update: "Update an existing product carbon model. Requires accountId and idempotencyKey.",
+    modeling_detail: "Get product carbon model details for an account.",
+    report_generate: "Generate a product carbon report. Requires idempotencyKey.",
+    report_detail: "Get product carbon report detail and latest report URL.",
+    analysis_run: "Run product carbon data analysis, such as hotspot analysis.",
+    factor_search: "Search and match carbon emission factors for Agent modeling.",
+    knowledge_search: "Search carbon knowledge for Agent answers.",
+};
+export const toolRoutes = {
+    session_context: {
+        method: "POST",
+        path: apipath.SessionContext(),
+        bodyKind: "sessionContext",
+    },
+    project_memory_get: {
+        method: "POST",
+        path: apipath.ProjectMemoryGet(),
+        bodyKind: "agentSkill",
+    },
+    project_memory_patch: {
+        method: "POST",
+        path: apipath.ProjectMemoryPatch(),
+        bodyKind: "agentSkill",
+    },
+    project_memory_compress: {
+        method: "POST",
+        path: apipath.ProjectMemoryCompress(),
+        bodyKind: "agentSkill",
+    },
+    modeling_preview: {
+        method: "POST",
+        path: apipath.ModelingPreview(),
+        bodyKind: "agentSkill",
+    },
+    modeling_execute: {
+        method: "POST",
+        path: apipath.ModelingExecute(),
+        bodyKind: "agentSkill",
+    },
+    modeling_update: {
+        method: "POST",
+        path: apipath.ModelingUpdate(),
+        bodyKind: "agentSkill",
+    },
+    modeling_detail: {
+        method: "POST",
+        path: apipath.ModelingDetail(),
+        bodyKind: "agentSkill",
+    },
+    report_generate: {
+        method: "POST",
+        path: apipath.ReportGenerate(),
+        bodyKind: "agentSkill",
+    },
+    report_detail: {
+        method: "POST",
+        path: apipath.ReportDetail(),
+        bodyKind: "agentSkill",
+    },
+    analysis_run: {
+        method: "POST",
+        path: apipath.AnalysisRun(),
+        bodyKind: "agentSkill",
+    },
+    factor_search: {
+        method: "POST",
+        path: apipath.FactorSearch(),
+        bodyKind: "agentSkill",
+    },
+    knowledge_search: {
+        method: "POST",
+        path: apipath.KnowledgeSearch(),
+        bodyKind: "agentSkill",
+    },
+};
+export function buildBody(route, args) {
+    if (route.bodyKind === "sessionContext") {
+        return { sessionId: args.sessionId };
+    }
+    return args;
+}
+export function getSessionId(args) {
+    const value = args.sessionId;
+    if (typeof value !== "string" || value.trim().length === 0) {
+        throw new Error("sessionId is required");
+    }
+    return value;
+}
+//# sourceMappingURL=tools.js.map

package/dist/tools.js.map

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

package/dist/version.d.ts

@@ -0,0 +1,4 @@
+export declare function getBaseURL(): string;
+export declare const Version = "0.1.0";
+export declare const Commit = "none";
+export declare const BuildTime = "unknown";

package/dist/version.js

@@ -0,0 +1,19 @@
+import { encodedBaseURL } from "./baseurl.js";
+export function getBaseURL() {
+    if (!encodedBaseURL)
+        return "";
+    // If it already looks like a URL, return as-is (dev / env override).
+    if (encodedBaseURL.includes("://"))
+        return encodedBaseURL;
+    // Release builds: base64-encoded to hide from strings/grep.
+    try {
+        return Buffer.from(encodedBaseURL, "base64").toString("utf-8");
+    }
+    catch {
+        return "";
+    }
+}
+export const Version = "0.1.0";
+export const Commit = "none";
+export const BuildTime = "unknown";
+//# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9C,MAAM,UAAU,UAAU;IACxB,IAAI,CAAC,cAAc;QAAE,OAAO,EAAE,CAAC;IAC/B,qEAAqE;IACrE,IAAI,cAAc,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,cAAc,CAAC;IAC1D,4DAA4D;IAC5D,IAAI,CAAC;QACH,OAAO,MAAM,CAAC,IAAI,CAAC,cAAc,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IACjE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC;AAC/B,MAAM,CAAC,MAAM,MAAM,GAAG,MAAM,CAAC;AAC7B,MAAM,CAAC,MAAM,SAAS,GAAG,SAAS,CAAC"}

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@carbonstopper/agent-mcp",
+  "version": "0.1.2",
+  "description": "MCP server for Carbonstop Agent internal skill APIs",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "carbonstop-agent-mcp": "dist/index.js"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/carbonstop-hub/carbonstop-agent-mcp.git"
+  },
+  "homepage": "https://github.com/carbonstop-hub/carbonstop-agent-mcp#readme",
+  "bugs": {
+    "url": "https://github.com/carbonstop-hub/carbonstop-agent-mcp/issues"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "AGENTS.md"
+  ],
+  "scripts": {
+    "prebuild": "node scripts/build.cjs",
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "dev": "tsx src/index.ts",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "mcp",
+    "carbon-footprint",
+    "carbonstop",
+    "agent",
+    "model-context-protocol"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "tsx": "^4.0.0",
+    "typescript": "^5.0.0"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}