kredit-mcp 0.1.0

package/README.md

@@ -0,0 +1,27 @@
+# kredit-mcp
+
+MCP server for Kredit. Bring agent spend controls to Claude Code and Claude Desktop.
+
+## Install
+
+```bash
+npm install -g kredit-mcp
+```
+
+## Usage with Claude Code
+
+```bash
+claude mcp add kredit -- kredit-mcp serve --api-key=kr_live_...
+```
+
+## Tools
+
+- `kredit_check` — risk evaluation before an action
+- `kredit_report` — report outcome after action
+- `kredit_balance` — check agent wallet and score
+- `kredit_agents` — list agents
+
+## Environment variables
+
+- `KREDIT_API_KEY` — API key for kredit-server
+- `KREDIT_API_URL` — API base URL (default: `https://api.kredit.sh`)

package/bin/kredit-mcp

@@ -0,0 +1,34 @@
+#!/usr/bin/env node
+
+import { resolve, dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+
+// The "serve" subcommand starts the MCP server.
+// All other flags (--api-key, --api-url) are forwarded to the server entry point.
+const args = process.argv.slice(2);
+
+const command = args[0];
+
+if (!command || command === "serve") {
+  // Import and run the server entry point — it reads config from process.argv
+  await import(resolve(__dirname, "../dist/index.js"));
+} else if (command === "--help" || command === "-h") {
+  console.log(`kredit-mcp — MCP server for Kredit
+
+Usage:
+  kredit-mcp serve [options]
+
+Options:
+  --api-key=KEY    Kredit API key (or set KREDIT_API_KEY env)
+  --api-url=URL    Kredit API URL (or set KREDIT_API_URL env, default: https://api.kredit.sh)
+
+Example:
+  claude mcp add kredit -- kredit-mcp serve --api-key=kr_live_...
+`);
+} else {
+  console.error(`Unknown command: ${command}`);
+  console.error("Usage: kredit-mcp serve [--api-key=KEY] [--api-url=URL]");
+  process.exit(1);
+}

package/dist/api.d.ts

@@ -0,0 +1,69 @@
+import type { Config } from "./config.js";
+export interface CheckRequest {
+    agent_id: string;
+    action: string;
+    estimated_cost: number;
+}
+export interface CheckResponse {
+    allow: boolean;
+    risk_level: "low" | "medium" | "high" | "critical";
+    txn_id: string;
+    status: "allowed" | "blocked" | "flagged";
+    block_reason: string | null;
+    agent: {
+        status: "active" | "throttled" | "frozen";
+        score: number;
+        wallet_balance: number;
+        wallet_budget: number;
+    };
+}
+export interface ReportRequest {
+    agent_id: string;
+    txn_id: string;
+    outcome: "success" | "failure" | "partial";
+    actual_cost: number;
+}
+export interface ReportResponse {
+    txn_id: string;
+    score_before: number;
+    score_after: number;
+    status: "active" | "throttled" | "frozen";
+}
+export interface AgentInfo {
+    id: string;
+    name: string;
+    org_id: string;
+    status: "active" | "throttled" | "frozen";
+    wallet: {
+        balance: number;
+        budget: number;
+        rate_limit: number;
+        rate_used: number;
+    };
+    credit: {
+        score: number;
+        task_success_rate: number;
+        cost_efficiency: number;
+        violation_count: number;
+        total_tasks: number;
+    };
+}
+export interface AgentListItem {
+    id: string;
+    name: string;
+    org_id: string;
+    status: "active" | "throttled" | "frozen";
+    score: number;
+    wallet_balance: number;
+}
+export declare class KreditAPI {
+    private baseUrl;
+    private apiKey;
+    constructor(config: Config);
+    private request;
+    check(req: CheckRequest): Promise<CheckResponse>;
+    report(req: ReportRequest): Promise<ReportResponse>;
+    getAgent(agentId: string): Promise<AgentInfo>;
+    listAgents(orgId?: string): Promise<AgentListItem[]>;
+}
+//# sourceMappingURL=api.d.ts.map

package/dist/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAM1C,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,OAAO,CAAC;IACf,UAAU,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAC;IACnD,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;IAC1C,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,KAAK,EAAE;QACL,MAAM,EAAE,QAAQ,GAAG,WAAW,GAAG,QAAQ,CAAC;QAC1C,KAAK,EAAE,MAAM,CAAC;QACd,cAAc,EAAE,MAAM,CAAC;QACvB,aAAa,EAAE,MAAM,CAAC;KACvB,CAAC;CACH;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;IAC3C,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,QAAQ,GAAG,WAAW,GAAG,QAAQ,CAAC;CAC3C;AAED,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,QAAQ,GAAG,WAAW,GAAG,QAAQ,CAAC;IAC1C,MAAM,EAAE;QACN,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;QACf,UAAU,EAAE,MAAM,CAAC;QACnB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,MAAM,EAAE;QACN,KAAK,EAAE,MAAM,CAAC;QACd,iBAAiB,EAAE,MAAM,CAAC;QAC1B,eAAe,EAAE,MAAM,CAAC;QACxB,eAAe,EAAE,MAAM,CAAC;QACxB,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;CACH;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,QAAQ,GAAG,WAAW,GAAG,QAAQ,CAAC;IAC1C,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,EAAE,MAAM,CAAC;CACxB;AAID,qBAAa,SAAS;IACpB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,MAAM,CAAS;gBAEX,MAAM,EAAE,MAAM;YAMZ,OAAO;IA+Cf,KAAK,CAAC,GAAG,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC;IAIhD,MAAM,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC;IAInD,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IAI7C,UAAU,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;CAI3D"}

package/dist/api.js

@@ -0,0 +1,59 @@
+const TIMEOUT_MS = 5_000;
+// ---- API client ----
+export class KreditAPI {
+    baseUrl;
+    apiKey;
+    constructor(config) {
+        // Strip trailing slash
+        this.baseUrl = config.apiUrl.replace(/\/+$/, "");
+        this.apiKey = config.apiKey;
+    }
+    async request(method, path, body) {
+        const url = `${this.baseUrl}${path}`;
+        const headers = {
+            "Content-Type": "application/json",
+        };
+        if (this.apiKey) {
+            headers["Authorization"] = `Bearer ${this.apiKey}`;
+        }
+        const controller = new AbortController();
+        const timeout = setTimeout(() => controller.abort(), TIMEOUT_MS);
+        try {
+            const response = await fetch(url, {
+                method,
+                headers,
+                body: body ? JSON.stringify(body) : undefined,
+                signal: controller.signal,
+            });
+            if (!response.ok) {
+                const text = await response.text().catch(() => "");
+                throw new Error(`Kredit API error: ${response.status} ${response.statusText}${text ? ` — ${text}` : ""}`);
+            }
+            return (await response.json());
+        }
+        catch (err) {
+            if (err instanceof Error &&
+                (err.name === "AbortError" || err.name === "TimeoutError")) {
+                throw new Error(`Kredit API timeout: ${method} ${path} exceeded ${TIMEOUT_MS}ms`);
+            }
+            throw err;
+        }
+        finally {
+            clearTimeout(timeout);
+        }
+    }
+    async check(req) {
+        return this.request("POST", "/check", req);
+    }
+    async report(req) {
+        return this.request("POST", "/report", req);
+    }
+    async getAgent(agentId) {
+        return this.request("GET", `/agents/${encodeURIComponent(agentId)}`);
+    }
+    async listAgents(orgId) {
+        const query = orgId ? `?org_id=${encodeURIComponent(orgId)}` : "";
+        return this.request("GET", `/agents${query}`);
+    }
+}
+//# sourceMappingURL=api.js.map

package/dist/api.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,10 @@
+export interface Config {
+    apiKey: string;
+    apiUrl: string;
+}
+/**
+ * Resolve configuration from env + CLI flags.
+ * CLI flags take precedence over env vars.
+ */
+export declare function resolveConfig(argv?: string[]): Config;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,MAAM;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AA4BD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,GAAE,MAAM,EAAiB,GAAG,MAAM,CAOnE"}

package/dist/config.js

@@ -0,0 +1,35 @@
+const DEFAULT_API_URL = "https://api.kredit.sh";
+/**
+ * Parse --api-key=VALUE and --api-url=VALUE from argv.
+ */
+function parseCLIFlags(argv) {
+    let apiKey;
+    let apiUrl;
+    for (let i = 0; i < argv.length; i++) {
+        const arg = argv[i];
+        if (arg.startsWith("--api-key=")) {
+            apiKey = arg.slice("--api-key=".length);
+        }
+        else if (arg === "--api-key" && i + 1 < argv.length) {
+            apiKey = argv[++i];
+        }
+        if (arg.startsWith("--api-url=")) {
+            apiUrl = arg.slice("--api-url=".length);
+        }
+        else if (arg === "--api-url" && i + 1 < argv.length) {
+            apiUrl = argv[++i];
+        }
+    }
+    return { apiKey, apiUrl };
+}
+/**
+ * Resolve configuration from env + CLI flags.
+ * CLI flags take precedence over env vars.
+ */
+export function resolveConfig(argv = process.argv) {
+    const flags = parseCLIFlags(argv);
+    const apiKey = flags.apiKey || process.env.KREDIT_API_KEY || "";
+    const apiUrl = flags.apiUrl || process.env.KREDIT_API_URL || DEFAULT_API_URL;
+    return { apiKey, apiUrl };
+}
+//# 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,MAAM,eAAe,GAAG,uBAAuB,CAAC;AAOhD;;GAEG;AACH,SAAS,aAAa,CAAC,IAAc;IACnC,IAAI,MAA0B,CAAC;IAC/B,IAAI,MAA0B,CAAC;IAE/B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QAEpB,IAAI,GAAG,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;YACjC,MAAM,GAAG,GAAG,CAAC,KAAK,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;QAC1C,CAAC;aAAM,IAAI,GAAG,KAAK,WAAW,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;YACtD,MAAM,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;QACrB,CAAC;QAED,IAAI,GAAG,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;YACjC,MAAM,GAAG,GAAG,CAAC,KAAK,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;QAC1C,CAAC;aAAM,IAAI,GAAG,KAAK,WAAW,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;YACtD,MAAM,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;QACrB,CAAC;IACH,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;AAC5B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,OAAiB,OAAO,CAAC,IAAI;IACzD,MAAM,KAAK,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;IAElC,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,EAAE,CAAC;IAChE,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,eAAe,CAAC;IAE7E,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;AAC5B,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { KreditAPI } from "./api.js";
+declare function createServer(api: KreditAPI): McpServer;
+export { createServer, KreditAPI };
+//# 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":";AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGpE,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAGrC,iBAAS,YAAY,CAAC,GAAG,EAAE,SAAS,GAAG,SAAS,CAwM/C;AAuBD,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,CAAC"}

package/dist/index.js

@@ -0,0 +1,186 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+import { KreditAPI } from "./api.js";
+import { resolveConfig } from "./config.js";
+function createServer(api) {
+    const server = new McpServer({
+        name: "kredit",
+        version: "0.1.0",
+    });
+    // ---- kredit_check ----
+    server.tool("kredit_check", "Risk evaluation before an action. Call this to check if an agent is allowed to perform a costly action. Returns allow/deny, risk level, and agent status.", {
+        agent_id: z.string().describe("The agent ID to check"),
+        action: z.string().describe("The action to evaluate (e.g. 'openai.chat', 'aws.ec2.run')"),
+        estimated_cost: z.number().int().min(0).describe("Estimated cost in cents"),
+    }, async ({ agent_id, action, estimated_cost }) => {
+        try {
+            const result = await api.check({ agent_id, action, estimated_cost });
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            allow: result.allow,
+                            risk_level: result.risk_level,
+                            txn_id: result.txn_id,
+                            status: result.status,
+                            block_reason: result.block_reason,
+                            agent_status: result.agent.status,
+                            agent_score: result.agent.score,
+                            wallet_balance_cents: result.agent.wallet_balance,
+                            wallet_budget_cents: result.agent.wallet_budget,
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Error: ${err instanceof Error ? err.message : String(err)}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+    // ---- kredit_report ----
+    server.tool("kredit_report", "Report outcome after an action completes. Call this after a costly action to report success/failure and actual cost. Updates the agent's credit score.", {
+        agent_id: z.string().describe("The agent ID"),
+        txn_id: z.string().describe("Transaction ID from the kredit_check response"),
+        outcome: z
+            .enum(["success", "failure", "partial"])
+            .describe("Outcome of the action"),
+        actual_cost: z.number().int().min(0).describe("Actual cost in cents"),
+    }, async ({ agent_id, txn_id, outcome, actual_cost }) => {
+        try {
+            const result = await api.report({ agent_id, txn_id, outcome, actual_cost });
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            txn_id: result.txn_id,
+                            score_before: result.score_before,
+                            score_after: result.score_after,
+                            agent_status: result.status,
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Error: ${err instanceof Error ? err.message : String(err)}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+    // ---- kredit_balance ----
+    server.tool("kredit_balance", "Check agent wallet balance and credit score. Use this to understand an agent's current spending capacity and risk standing.", {
+        agent_id: z.string().describe("The agent ID to look up"),
+    }, async ({ agent_id }) => {
+        try {
+            const agent = await api.getAgent(agent_id);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            id: agent.id,
+                            name: agent.name,
+                            status: agent.status,
+                            wallet: {
+                                balance_cents: agent.wallet.balance,
+                                budget_cents: agent.wallet.budget,
+                                rate_limit_cents_per_hour: agent.wallet.rate_limit,
+                                rate_used_cents: agent.wallet.rate_used,
+                            },
+                            credit: {
+                                score: agent.credit.score,
+                                task_success_rate: agent.credit.task_success_rate,
+                                cost_efficiency: agent.credit.cost_efficiency,
+                                violation_count: agent.credit.violation_count,
+                                total_tasks: agent.credit.total_tasks,
+                            },
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Error: ${err instanceof Error ? err.message : String(err)}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+    // ---- kredit_agents ----
+    server.tool("kredit_agents", "List agents and their statuses. Optionally filter by organization.", {
+        org_id: z
+            .string()
+            .optional()
+            .describe("Organization ID to filter by (optional)"),
+    }, async ({ org_id }) => {
+        try {
+            const agents = await api.listAgents(org_id);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify(agents.map((a) => ({
+                            id: a.id,
+                            name: a.name,
+                            org_id: a.org_id,
+                            status: a.status,
+                            score: a.score,
+                            wallet_balance_cents: a.wallet_balance,
+                        })), null, 2),
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Error: ${err instanceof Error ? err.message : String(err)}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+    return server;
+}
+async function main() {
+    const config = resolveConfig();
+    if (!config.apiKey) {
+        console.error("Warning: No KREDIT_API_KEY set. Provide via env or --api-key flag.");
+    }
+    const api = new KreditAPI(config);
+    const server = createServer(api);
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+main().catch((err) => {
+    console.error("Fatal:", err);
+    process.exit(1);
+});
+export { createServer, KreditAPI };
+//# 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/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "kredit-mcp",
+  "version": "0.1.0",
+  "description": "MCP server for Kredit — bring agent spend controls to Claude Code and Claude Desktop",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "kredit-mcp": "./bin/kredit-mcp"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "start": "node dist/index.js",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "biome check src/ test/",
+    "format": "biome format --write src/ test/"
+  },
+  "files": [
+    "dist",
+    "bin"
+  ],
+  "keywords": [
+    "mcp",
+    "kredit",
+    "claude",
+    "agent",
+    "risk"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.1"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^1.9.4",
+    "@types/node": "^25.5.2",
+    "typescript": "^5.7.3",
+    "vitest": "^3.1.1"
+  }
+}