@rickydata/agent0-mcp 0.1.0

package/.env.example

@@ -0,0 +1,17 @@
+# Transport: stdio (default) or http
+TRANSPORT=stdio
+PORT=8080
+
+# Agent0 / ERC-8004 configuration
+AGENT0_CHAIN_ID=11155111
+# AGENT0_RPC_URL=https://sepolia.infura.io/v3/YOUR_KEY
+
+# Wallet for write operations (choose one)
+# ERC8004_PRIVATE_KEY=0x...
+# ERC8004_DERIVED_KEY=0x...
+
+# IPFS for agent registration
+# PINATA_JWT=your_pinata_jwt
+
+# Response capping
+RESPONSE_MAX_LENGTH=200000

package/Dockerfile

@@ -0,0 +1,25 @@
+FROM node:22-alpine AS builder
+WORKDIR /app
+COPY package*.json tsconfig.json ./
+RUN npm ci
+COPY src ./src
+RUN npm run build
+
+FROM node:22-alpine
+WORKDIR /app
+COPY package*.json ./
+RUN npm ci --only=production
+COPY --from=builder /app/dist ./dist
+
+ENV NODE_ENV=production
+ENV PORT=8080
+
+RUN addgroup -g 1001 -S nodejs && adduser -S nodejs -u 1001
+USER nodejs
+
+EXPOSE 8080
+
+HEALTHCHECK --interval=30s --timeout=10s --start-period=5s --retries=3 \
+    CMD node -e "require('http').get('http://localhost:8080/health', (r) => {r.statusCode === 200 ? process.exit(0) : process.exit(1)})"
+
+CMD ["node", "dist/index.js"]

package/README.md

@@ -0,0 +1,85 @@
+# @rickydata/agent0-mcp
+
+MCP server wrapping the [Agent0 SDK](https://www.npmjs.com/package/agent0-sdk) for ERC-8004 trustless agent operations. Discover, register, and interact with on-chain AI agents across Ethereum, Base, and Polygon.
+
+## Quick Connect
+
+```bash
+# stdio (Claude Code / Claude Desktop)
+cd packages/agent0-mcp && npm run dev -- --stdio
+
+# HTTP (Streamable HTTP transport)
+cd packages/agent0-mcp && PORT=8080 npm run dev
+
+# Claude Code
+claude mcp add --transport http agent0-mcp http://localhost:8080/mcp
+```
+
+## Tools (17)
+
+### Discovery (read-only, no auth needed)
+| Tool | Description |
+|------|-------------|
+| `search_agents` | Multi-chain agent search with filters (name, tools, skills, reputation) |
+| `get_agent` | Get agent details by chainId:tokenId |
+| `get_supported_chains` | List ERC-8004 supported chains and registry addresses |
+| `get_platform_stats` | Aggregate stats (total agents, MCP/A2A/x402 counts) |
+| `get_reputation_summary` | Reputation count + average + trust label for an agent |
+| `search_feedback` | Search feedback by agent, reviewer, tags, value range |
+
+### Authentication
+| Tool | Description |
+|------|-------------|
+| `configure_wallet` | Set up wallet for write ops (private key or signature derivation) |
+| `get_derivation_message` | Get the message to sign for key derivation |
+| `get_auth_status` | Check wallet configuration status |
+
+### Registration (requires wallet)
+| Tool | Description |
+|------|-------------|
+| `register_agent` | Register new agent on-chain (IPFS or data URI) |
+| `update_agent` | Update existing agent properties |
+
+### Reputation (requires wallet)
+| Tool | Description |
+|------|-------------|
+| `give_feedback` | Submit on-chain feedback/review (0-100 score) |
+| `revoke_feedback` | Revoke previously submitted feedback |
+
+### Payments
+| Tool | Description |
+|------|-------------|
+| `x402_request` | HTTP request with x402 payment handling |
+
+### A2A (requires wallet)
+| Tool | Description |
+|------|-------------|
+| `a2a_send_message` | Send message to agent via A2A protocol |
+| `a2a_list_tasks` | List A2A tasks/conversations |
+| `a2a_get_task` | Get A2A task details |
+
+## Environment Variables
+
+| Variable | Required | Description |
+|----------|----------|-------------|
+| `AGENT0_CHAIN_ID` | No | Default chain (default: 11155111 Sepolia) |
+| `AGENT0_RPC_URL` | No | Custom RPC URL |
+| `ERC8004_PRIVATE_KEY` | No | Direct private key for write ops |
+| `ERC8004_DERIVED_KEY` | No | Previously derived key |
+| `PINATA_JWT` | No | Pinata JWT for IPFS registration |
+
+## Development
+
+```bash
+npm install
+npm run dev       # stdio mode
+npm run build     # compile TypeScript
+npm test          # run vitest
+```
+
+## Docker
+
+```bash
+docker build -t agent0-mcp .
+docker run -p 8080:8080 agent0-mcp
+```

package/dist/auth/sdk-client.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Agent0 SDK client management.
+ *
+ * Provides read-only and authenticated SDK instances for ERC-8004 operations.
+ *
+ * Key resolution order:
+ * 1. ERC8004_PRIVATE_KEY env var (explicit private key)
+ * 2. ERC8004_DERIVED_KEY env var (previously derived key from wallet signature)
+ * 3. Prompt user for wallet signature derivation (via configure_wallet tool)
+ */
+import { SDK } from "agent0-sdk";
+/**
+ * Get a read-only SDK instance (no signing capabilities).
+ * Suitable for search, discovery, and reputation queries.
+ */
+export declare function getReadOnlySDK(chainId?: number): SDK;
+/**
+ * Get an authenticated SDK instance (with signing capabilities).
+ * Returns null if no private key is available.
+ */
+export declare function getAuthenticatedSDK(chainId?: number): SDK | null;
+/**
+ * Set the derived private key (from wallet signature derivation).
+ * Clears cached authenticated SDK so it's rebuilt on next access.
+ */
+export declare function setDerivedKey(privateKey: string): void;
+/**
+ * Check if an authenticated SDK is available (has a private key).
+ */
+export declare function hasAuthentication(): boolean;
+/**
+ * Get the current chain ID.
+ */
+export declare function getCurrentChainId(): number;
+/**
+ * Set the current chain ID (clears cached SDK instances).
+ */
+export declare function setChainId(chainId: number): void;
+/**
+ * Get authentication status information.
+ */
+export declare function getAuthStatus(): {
+    hasKey: boolean;
+    chainId: number;
+    source: "env:ERC8004_PRIVATE_KEY" | "env:ERC8004_DERIVED_KEY" | "derived" | "none";
+    isReadOnly: boolean;
+};

package/dist/auth/sdk-client.js

@@ -0,0 +1,142 @@
+/**
+ * Agent0 SDK client management.
+ *
+ * Provides read-only and authenticated SDK instances for ERC-8004 operations.
+ *
+ * Key resolution order:
+ * 1. ERC8004_PRIVATE_KEY env var (explicit private key)
+ * 2. ERC8004_DERIVED_KEY env var (previously derived key from wallet signature)
+ * 3. Prompt user for wallet signature derivation (via configure_wallet tool)
+ */
+import { SDK } from "agent0-sdk";
+// ============================================================================
+// CONFIGURATION
+// ============================================================================
+const DEFAULT_CHAIN_ID = parseInt(process.env.AGENT0_CHAIN_ID || "11155111", 10);
+const RPC_URL = process.env.AGENT0_RPC_URL;
+const IPFS_PROVIDER = (process.env.AGENT0_IPFS_PROVIDER || "pinata");
+const PINATA_JWT = process.env.PINATA_JWT;
+// ============================================================================
+// SDK CLIENT STATE
+// ============================================================================
+let _readOnlySDK = null;
+let _authenticatedSDK = null;
+let _currentPrivateKey = null;
+let _currentChainId = DEFAULT_CHAIN_ID;
+/**
+ * Resolve the private key from environment or stored state.
+ * Returns null if no key is available (read-only mode).
+ */
+function resolvePrivateKey() {
+    // 1. Explicit private key
+    if (process.env.ERC8004_PRIVATE_KEY) {
+        return process.env.ERC8004_PRIVATE_KEY;
+    }
+    // 2. Previously derived key
+    if (process.env.ERC8004_DERIVED_KEY) {
+        return process.env.ERC8004_DERIVED_KEY;
+    }
+    // 3. Stored from configure_wallet
+    return _currentPrivateKey;
+}
+/**
+ * Build SDK config for the given chain.
+ */
+function buildConfig(chainId, privateKey) {
+    const config = { chainId };
+    if (RPC_URL)
+        config.rpcUrl = RPC_URL;
+    if (privateKey)
+        config.privateKey = privateKey;
+    // Only configure IPFS when we have a private key (write operations need IPFS)
+    if (privateKey && PINATA_JWT) {
+        config.ipfs = IPFS_PROVIDER;
+        config.pinataJwt = PINATA_JWT;
+    }
+    return config;
+}
+// ============================================================================
+// PUBLIC API
+// ============================================================================
+/**
+ * Get a read-only SDK instance (no signing capabilities).
+ * Suitable for search, discovery, and reputation queries.
+ */
+export function getReadOnlySDK(chainId) {
+    const targetChain = chainId ?? _currentChainId;
+    // Cache the read-only SDK for the current chain
+    if (_readOnlySDK && targetChain === _currentChainId) {
+        return _readOnlySDK;
+    }
+    _readOnlySDK = new SDK(buildConfig(targetChain));
+    if (!chainId)
+        _currentChainId = targetChain;
+    return _readOnlySDK;
+}
+/**
+ * Get an authenticated SDK instance (with signing capabilities).
+ * Returns null if no private key is available.
+ */
+export function getAuthenticatedSDK(chainId) {
+    const privateKey = resolvePrivateKey();
+    if (!privateKey)
+        return null;
+    const targetChain = chainId ?? _currentChainId;
+    // Return cached if key and chain haven't changed
+    if (_authenticatedSDK &&
+        _currentPrivateKey === privateKey &&
+        targetChain === _currentChainId) {
+        return _authenticatedSDK;
+    }
+    _authenticatedSDK = new SDK(buildConfig(targetChain, privateKey));
+    _currentPrivateKey = privateKey;
+    _currentChainId = targetChain;
+    return _authenticatedSDK;
+}
+/**
+ * Set the derived private key (from wallet signature derivation).
+ * Clears cached authenticated SDK so it's rebuilt on next access.
+ */
+export function setDerivedKey(privateKey) {
+    _currentPrivateKey = privateKey;
+    _authenticatedSDK = null;
+}
+/**
+ * Check if an authenticated SDK is available (has a private key).
+ */
+export function hasAuthentication() {
+    return resolvePrivateKey() !== null;
+}
+/**
+ * Get the current chain ID.
+ */
+export function getCurrentChainId() {
+    return _currentChainId;
+}
+/**
+ * Set the current chain ID (clears cached SDK instances).
+ */
+export function setChainId(chainId) {
+    _currentChainId = chainId;
+    _readOnlySDK = null;
+    _authenticatedSDK = null;
+}
+/**
+ * Get authentication status information.
+ */
+export function getAuthStatus() {
+    let source = "none";
+    if (process.env.ERC8004_PRIVATE_KEY)
+        source = "env:ERC8004_PRIVATE_KEY";
+    else if (process.env.ERC8004_DERIVED_KEY)
+        source = "env:ERC8004_DERIVED_KEY";
+    else if (_currentPrivateKey)
+        source = "derived";
+    return {
+        hasKey: source !== "none",
+        chainId: _currentChainId,
+        source,
+        isReadOnly: source === "none",
+    };
+}
+//# sourceMappingURL=sdk-client.js.map

package/dist/auth/sdk-client.js.map

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

package/dist/auth/token.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Re-exports for auth module.
+ */
+export { getDerivationMessage, deriveWalletFromSignature, verifyDerivationSignature, type DerivedWallet, } from "./wallet-derivation.js";
+export { getReadOnlySDK, getAuthenticatedSDK, setDerivedKey, hasAuthentication, getCurrentChainId, setChainId, getAuthStatus, } from "./sdk-client.js";

package/dist/auth/token.js

@@ -0,0 +1,6 @@
+/**
+ * Re-exports for auth module.
+ */
+export { getDerivationMessage, deriveWalletFromSignature, verifyDerivationSignature, } from "./wallet-derivation.js";
+export { getReadOnlySDK, getAuthenticatedSDK, setDerivedKey, hasAuthentication, getCurrentChainId, setChainId, getAuthStatus, } from "./sdk-client.js";
+//# sourceMappingURL=token.js.map

package/dist/auth/token.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"token.js","sourceRoot":"","sources":["../../src/auth/token.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EACL,oBAAoB,EACpB,yBAAyB,EACzB,yBAAyB,GAE1B,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,aAAa,EACb,iBAAiB,EACjB,iBAAiB,EACjB,UAAU,EACV,aAAa,GACd,MAAM,iBAAiB,CAAC"}

package/dist/auth/wallet-derivation.d.ts

@@ -0,0 +1,26 @@
+export interface DerivedWallet {
+    address: string;
+    privateKey: string;
+}
+/**
+ * Get the deterministic message that must be signed for key derivation.
+ */
+export declare function getDerivationMessage(): string;
+/**
+ * Derive an ERC-8004 agent wallet from a wallet signature.
+ *
+ * Uses HKDF-SHA256 to extract a 32-byte private key from the signature.
+ * The same signature always produces the same derived key.
+ *
+ * @param signature - The wallet's signature of DERIVATION_MESSAGE (hex string with 0x prefix)
+ * @returns DerivedWallet with address and privateKey
+ */
+export declare function deriveWalletFromSignature(signature: string): DerivedWallet;
+/**
+ * Verify that a signature was produced by the expected wallet address.
+ *
+ * @param signature - The signature to verify
+ * @param expectedAddress - The wallet address that should have signed
+ * @returns true if the signature was produced by expectedAddress
+ */
+export declare function verifyDerivationSignature(signature: string, expectedAddress: string): boolean;

package/dist/auth/wallet-derivation.js

@@ -0,0 +1,76 @@
+/**
+ * Wallet derivation for ERC-8004 agent identity.
+ *
+ * Derives a deterministic private key from a wallet signature using HKDF.
+ * This allows an MCP client user to derive a signing key for ERC-8004 operations
+ * without exposing their main wallet private key.
+ *
+ * Flow:
+ * 1. User signs a deterministic message with their wallet
+ * 2. HKDF extracts a derived key from the signature
+ * 3. The derived key is used for agent0-sdk write operations
+ */
+import { hkdf } from "@noble/hashes/hkdf";
+import { sha256 } from "@noble/hashes/sha2";
+import { ethers } from "ethers";
+/**
+ * The deterministic signing message used to derive the key.
+ * CRITICAL: This MUST NOT contain nonces, timestamps, or any variable data.
+ * If changed, all previously derived keys become invalid.
+ */
+const DERIVATION_MESSAGE = "Sign this message to derive your ERC-8004 agent key.\n\n" +
+    "This signature will be used to create a deterministic private key " +
+    "for managing your on-chain agent identity. " +
+    "This does not grant access to your funds.";
+/**
+ * Get the deterministic message that must be signed for key derivation.
+ */
+export function getDerivationMessage() {
+    return DERIVATION_MESSAGE;
+}
+/**
+ * Derive an ERC-8004 agent wallet from a wallet signature.
+ *
+ * Uses HKDF-SHA256 to extract a 32-byte private key from the signature.
+ * The same signature always produces the same derived key.
+ *
+ * @param signature - The wallet's signature of DERIVATION_MESSAGE (hex string with 0x prefix)
+ * @returns DerivedWallet with address and privateKey
+ */
+export function deriveWalletFromSignature(signature) {
+    if (!signature || !signature.startsWith("0x")) {
+        throw new Error("Invalid signature: must be a hex string starting with 0x");
+    }
+    // Convert signature to bytes
+    const sigBytes = ethers.getBytes(signature);
+    // HKDF: extract + expand
+    // salt: "agent0-erc8004" (domain separation)
+    // info: "agent-key-v1" (versioned derivation context)
+    const salt = new TextEncoder().encode("agent0-erc8004");
+    const info = new TextEncoder().encode("agent-key-v1");
+    const derivedKeyBytes = hkdf(sha256, sigBytes, salt, info, 32);
+    // Create ethers wallet from derived key
+    const privateKey = ethers.hexlify(derivedKeyBytes);
+    const wallet = new ethers.Wallet(privateKey);
+    return {
+        address: wallet.address,
+        privateKey,
+    };
+}
+/**
+ * Verify that a signature was produced by the expected wallet address.
+ *
+ * @param signature - The signature to verify
+ * @param expectedAddress - The wallet address that should have signed
+ * @returns true if the signature was produced by expectedAddress
+ */
+export function verifyDerivationSignature(signature, expectedAddress) {
+    try {
+        const recovered = ethers.verifyMessage(DERIVATION_MESSAGE, signature);
+        return recovered.toLowerCase() === expectedAddress.toLowerCase();
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=wallet-derivation.js.map

package/dist/auth/wallet-derivation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wallet-derivation.js","sourceRoot":"","sources":["../../src/auth/wallet-derivation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAC1C,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAOhC;;;;GAIG;AACH,MAAM,kBAAkB,GACtB,0DAA0D;IAC1D,oEAAoE;IACpE,6CAA6C;IAC7C,2CAA2C,CAAC;AAE9C;;GAEG;AACH,MAAM,UAAU,oBAAoB;IAClC,OAAO,kBAAkB,CAAC;AAC5B,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,yBAAyB,CAAC,SAAiB;IACzD,IAAI,CAAC,SAAS,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QAC9C,MAAM,IAAI,KAAK,CAAC,0DAA0D,CAAC,CAAC;IAC9E,CAAC;IAED,6BAA6B;IAC7B,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;IAE5C,yBAAyB;IACzB,6CAA6C;IAC7C,sDAAsD;IACtD,MAAM,IAAI,GAAG,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC;IACxD,MAAM,IAAI,GAAG,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC;IACtD,MAAM,eAAe,GAAG,IAAI,CAAC,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC;IAE/D,wCAAwC;IACxC,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC;IACnD,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IAE7C,OAAO;QACL,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,UAAU;KACX,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,yBAAyB,CACvC,SAAiB,EACjB,eAAuB;IAEvB,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,MAAM,CAAC,aAAa,CAAC,kBAAkB,EAAE,SAAS,CAAC,CAAC;QACtE,OAAO,SAAS,CAAC,WAAW,EAAE,KAAK,eAAe,CAAC,WAAW,EAAE,CAAC;IACnE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/index.js

@@ -0,0 +1,140 @@
+import { randomUUID } from "node:crypto";
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
+import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import express from "express";
+import cors from "cors";
+import { TOOLS, handleToolCall } from "./tools/index.js";
+// ============================================================================
+// CONFIGURATION
+// ============================================================================
+const RESPONSE_MAX_LENGTH = parseInt(process.env.RESPONSE_MAX_LENGTH || "200000", 10);
+const SERVER_NAME = "agent0-mcp";
+const SERVER_VERSION = "0.1.0";
+// ============================================================================
+// RESPONSE CAPPING
+// ============================================================================
+function truncateResponse(result) {
+    const text = typeof result === "string" ? result : JSON.stringify(result, null, 2);
+    if (text.length <= RESPONSE_MAX_LENGTH)
+        return text;
+    return (text.slice(0, RESPONSE_MAX_LENGTH) +
+        `\n\n--- Response truncated (${text.length} chars, limit ${RESPONSE_MAX_LENGTH}) ---`);
+}
+// ============================================================================
+// MCP HANDLER SETUP
+// ============================================================================
+function setupMCPHandlers(server) {
+    server.setRequestHandler(ListToolsRequestSchema, async () => ({
+        tools: TOOLS,
+    }));
+    server.setRequestHandler(CallToolRequestSchema, async (request) => {
+        const { name, arguments: args = {} } = request.params;
+        let result;
+        try {
+            result = await handleToolCall(name, args);
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            result = { success: false, error: message };
+        }
+        const content = truncateResponse(result);
+        return {
+            content: [{ type: "text", text: content }],
+        };
+    });
+}
+const sessions = new Map();
+// Clean up sessions older than 2 hours
+setInterval(() => {
+    const now = Date.now();
+    for (const [id, session] of sessions) {
+        if (now - session.createdAt > 2 * 60 * 60 * 1000) {
+            session.transport.close();
+            session.server.close();
+            sessions.delete(id);
+        }
+    }
+}, 5 * 60 * 1000);
+function createServer() {
+    return new Server({ name: SERVER_NAME, version: SERVER_VERSION }, { capabilities: { tools: { listChanged: false } } });
+}
+// ============================================================================
+// TRANSPORT: HTTP (StreamableHTTP)
+// ============================================================================
+const app = express();
+app.use(cors());
+app.use(express.json());
+app.get("/health", (_req, res) => {
+    res.json({
+        status: "ok",
+        server: SERVER_NAME,
+        version: SERVER_VERSION,
+        tools: TOOLS.length,
+        sessions: sessions.size,
+    });
+});
+app.post("/mcp", async (req, res) => {
+    const sessionId = req.headers["mcp-session-id"];
+    if (sessionId && sessions.has(sessionId)) {
+        const session = sessions.get(sessionId);
+        await session.transport.handleRequest(req, res, req.body);
+    }
+    else {
+        const newId = randomUUID();
+        const server = createServer();
+        setupMCPHandlers(server);
+        const transport = new StreamableHTTPServerTransport({
+            sessionIdGenerator: () => newId,
+        });
+        await server.connect(transport);
+        sessions.set(newId, { server, transport, createdAt: Date.now() });
+        await transport.handleRequest(req, res, req.body);
+    }
+});
+app.get("/mcp", async (req, res) => {
+    const sessionId = req.headers["mcp-session-id"];
+    if (!sessionId || !sessions.has(sessionId)) {
+        res.status(400).json({
+            error: "Invalid or missing session. Send initialize first via POST.",
+        });
+        return;
+    }
+    await sessions.get(sessionId).transport.handleRequest(req, res);
+});
+app.delete("/mcp", async (req, res) => {
+    const sessionId = req.headers["mcp-session-id"];
+    if (sessionId && sessions.has(sessionId)) {
+        const session = sessions.get(sessionId);
+        await session.transport.handleRequest(req, res);
+        session.transport.close();
+        session.server.close();
+        sessions.delete(sessionId);
+    }
+    else {
+        res.status(400).json({ error: "Invalid or missing session." });
+    }
+});
+// ============================================================================
+// START
+// ============================================================================
+const isStdio = process.argv.includes("--stdio");
+if (isStdio) {
+    // In stdio mode, redirect console.log to stderr so it doesn't pollute the MCP JSON stream
+    console.log = console.error;
+    const server = createServer();
+    setupMCPHandlers(server);
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error(`${SERVER_NAME} running on stdio (${TOOLS.length} tools)`);
+}
+else {
+    const port = parseInt(process.env.PORT || "8080", 10);
+    app.listen(port, () => {
+        console.log(`${SERVER_NAME} running on port ${port}`);
+        console.log(`Tools: ${TOOLS.length}`);
+        console.log(`Endpoints: /health /mcp`);
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,6BAA6B,EAAE,MAAM,oDAAoD,CAAC;AACnG,OAAO,EACL,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,OAAO,MAAM,SAAS,CAAC;AAC9B,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEzD,+EAA+E;AAC/E,gBAAgB;AAChB,+EAA+E;AAE/E,MAAM,mBAAmB,GAAG,QAAQ,CAClC,OAAO,CAAC,GAAG,CAAC,mBAAmB,IAAI,QAAQ,EAC3C,EAAE,CACH,CAAC;AACF,MAAM,WAAW,GAAG,YAAY,CAAC;AACjC,MAAM,cAAc,GAAG,OAAO,CAAC;AAE/B,+EAA+E;AAC/E,mBAAmB;AACnB,+EAA+E;AAE/E,SAAS,gBAAgB,CAAC,MAAe;IACvC,MAAM,IAAI,GACR,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IACxE,IAAI,IAAI,CAAC,MAAM,IAAI,mBAAmB;QAAE,OAAO,IAAI,CAAC;IACpD,OAAO,CACL,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,mBAAmB,CAAC;QAClC,+BAA+B,IAAI,CAAC,MAAM,iBAAiB,mBAAmB,OAAO,CACtF,CAAC;AACJ,CAAC;AAED,+EAA+E;AAC/E,oBAAoB;AACpB,+EAA+E;AAE/E,SAAS,gBAAgB,CAAC,MAAc;IACtC,MAAM,CAAC,iBAAiB,CAAC,sBAAsB,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;QAC5D,KAAK,EAAE,KAAK;KACb,CAAC,CAAC,CAAC;IAEJ,MAAM,CAAC,iBAAiB,CAAC,qBAAqB,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;QAChE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;QACtD,IAAI,MAAe,CAAC;QAEpB,IAAI,CAAC;YACH,MAAM,GAAG,MAAM,cAAc,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAC5C,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,MAAM,OAAO,GACX,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACzD,MAAM,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;QAC9C,CAAC;QAED,MAAM,OAAO,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC;QACzC,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;SACpD,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAYD,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAsB,CAAC;AAE/C,uCAAuC;AACvC,WAAW,CACT,GAAG,EAAE;IACH,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACvB,KAAK,MAAM,CAAC,EAAE,EAAE,OAAO,CAAC,IAAI,QAAQ,EAAE,CAAC;QACrC,IAAI,GAAG,GAAG,OAAO,CAAC,SAAS,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,CAAC;YACjD,OAAO,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;YAC1B,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;YACvB,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACtB,CAAC;IACH,CAAC;AACH,CAAC,EACD,CAAC,GAAG,EAAE,GAAG,IAAI,CACd,CAAC;AAEF,SAAS,YAAY;IACnB,OAAO,IAAI,MAAM,CACf,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,cAAc,EAAE,EAC9C,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,EAAE,WAAW,EAAE,KAAK,EAAE,EAAE,EAAE,CACpD,CAAC;AACJ,CAAC;AAED,+EAA+E;AAC/E,mCAAmC;AACnC,+EAA+E;AAE/E,MAAM,GAAG,GAAG,OAAO,EAAE,CAAC;AACtB,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;AAChB,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;AAExB,GAAG,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE;IAC/B,GAAG,CAAC,IAAI,CAAC;QACP,MAAM,EAAE,IAAI;QACZ,MAAM,EAAE,WAAW;QACnB,OAAO,EAAE,cAAc;QACvB,KAAK,EAAE,KAAK,CAAC,MAAM;QACnB,QAAQ,EAAE,QAAQ,CAAC,IAAI;KACxB,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE;IAClC,MAAM,SAAS,GAAG,GAAG,CAAC,OAAO,CAAC,gBAAgB,CAAuB,CAAC;IAEtE,IAAI,SAAS,IAAI,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;QACzC,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAE,CAAC;QACzC,MAAM,OAAO,CAAC,SAAS,CAAC,aAAa,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC;IAC5D,CAAC;SAAM,CAAC;QACN,MAAM,KAAK,GAAG,UAAU,EAAE,CAAC;QAC3B,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;QAC9B,gBAAgB,CAAC,MAAM,CAAC,CAAC;QAEzB,MAAM,SAAS,GAAG,IAAI,6BAA6B,CAAC;YAClD,kBAAkB,EAAE,GAAG,EAAE,CAAC,KAAK;SAChC,CAAC,CAAC;QACH,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAEhC,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QAClE,MAAM,SAAS,CAAC,aAAa,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC;IACpD,CAAC;AACH,CAAC,CAAC,CAAC;AAEH,GAAG,CAAC,GAAG,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE;IACjC,MAAM,SAAS,GAAG,GAAG,CAAC,OAAO,CAAC,gBAAgB,CAAuB,CAAC;IACtE,IAAI,CAAC,SAAS,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;QAC3C,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;YACnB,KAAK,EAAE,6DAA6D;SACrE,CAAC,CAAC;QACH,OAAO;IACT,CAAC;IACD,MAAM,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAE,CAAC,SAAS,CAAC,aAAa,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;AACnE,CAAC,CAAC,CAAC;AAEH,GAAG,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE;IACpC,MAAM,SAAS,GAAG,GAAG,CAAC,OAAO,CAAC,gBAAgB,CAAuB,CAAC;IACtE,IAAI,SAAS,IAAI,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;QACzC,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAE,CAAC;QACzC,MAAM,OAAO,CAAC,SAAS,CAAC,aAAa,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;QAChD,OAAO,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;QAC1B,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QACvB,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAC7B,CAAC;SAAM,CAAC;QACN,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,6BAA6B,EAAE,CAAC,CAAC;IACjE,CAAC;AACH,CAAC,CAAC,CAAC;AAEH,+EAA+E;AAC/E,QAAQ;AACR,+EAA+E;AAE/E,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;AAEjD,IAAI,OAAO,EAAE,CAAC;IACZ,0FAA0F;IAC1F,OAAO,CAAC,GAAG,GAAG,OAAO,CAAC,KAAK,CAAC;IAC5B,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;IAC9B,gBAAgB,CAAC,MAAM,CAAC,CAAC;IACzB,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,OAAO,CAAC,KAAK,CAAC,GAAG,WAAW,sBAAsB,KAAK,CAAC,MAAM,SAAS,CAAC,CAAC;AAC3E,CAAC;KAAM,CAAC;IACN,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,MAAM,EAAE,EAAE,CAAC,CAAC;IACtD,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG,EAAE;QACpB,OAAO,CAAC,GAAG,CAAC,GAAG,WAAW,oBAAoB,IAAI,EAAE,CAAC,CAAC;QACtD,OAAO,CAAC,GAAG,CAAC,UAAU,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;QACtC,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAC;IACzC,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/tools/a2a.d.ts

@@ -0,0 +1,3 @@
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+export declare const a2aTools: Tool[];
+export declare function handleA2ATool(name: string, args: Record<string, unknown>): Promise<unknown>;