@sly_ai/mcp-server 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+#!/usr/bin/env node
+export { tools } from './tools.js';
+export { McpContext, createMcpServer } from './server-factory.js';
+import '@modelcontextprotocol/sdk/types.js';
+import '@modelcontextprotocol/sdk/server/index.js';
+import '@sly/sdk';

package/dist/index.js

@@ -0,0 +1,44 @@
+#!/usr/bin/env node
+import {
+  createMcpServer
+} from "./chunk-OHTORKDB.js";
+import {
+  tools
+} from "./chunk-YDZJAN2U.js";
+
+// src/index.ts
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { Sly, getEnvironmentConfig } from "@sly/sdk";
+var SLY_API_KEY = process.env.SLY_API_KEY;
+var SLY_API_KEY_LIVE = process.env.SLY_API_KEY_LIVE;
+var SLY_ENVIRONMENT = process.env.SLY_ENVIRONMENT || "sandbox";
+if (!SLY_API_KEY) {
+  console.error("Error: SLY_API_KEY environment variable is required");
+  process.exit(1);
+}
+var sly = new Sly({
+  apiKey: SLY_API_KEY,
+  environment: SLY_ENVIRONMENT,
+  apiUrl: process.env.SLY_API_URL
+});
+var SLY_API_URL = process.env.SLY_API_URL || getEnvironmentConfig(SLY_ENVIRONMENT).apiUrl;
+var keys = { sandbox: SLY_API_KEY };
+if (SLY_API_KEY_LIVE) keys.production = SLY_API_KEY_LIVE;
+var SLY_API_URL_LIVE = process.env.SLY_API_URL_LIVE;
+var urls = { sandbox: SLY_API_URL };
+if (SLY_API_URL_LIVE) urls.production = SLY_API_URL_LIVE;
+var server = createMcpServer(sly, SLY_API_URL, SLY_API_KEY, keys, urls);
+async function main() {
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+  console.error("Sly MCP server running on stdio");
+  console.error(`Environment: ${SLY_ENVIRONMENT}`);
+}
+main().catch((error) => {
+  console.error("Fatal error:", error);
+  process.exit(1);
+});
+export {
+  createMcpServer,
+  tools
+};

package/dist/server-factory.d.ts

@@ -0,0 +1,28 @@
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { Sly } from '@sly/sdk';
+
+/**
+ * MCP Server Factory
+ *
+ * Creates a configured MCP Server instance that can be connected
+ * to any transport (stdio, HTTP, etc.).
+ */
+
+/**
+ * Mutable runtime context for the MCP server.
+ * Allows switching environments (sandbox ↔ production) without restart.
+ */
+interface McpContext {
+    sly: Sly;
+    apiUrl: string;
+    apiKey: string;
+    environment: string;
+    keys: Record<string, string>;
+    urls: Record<string, string>;
+}
+/**
+ * Create an MCP Server with all Sly tools registered.
+ */
+declare function createMcpServer(sly: Sly, apiUrl: string, apiKey: string, keys?: Record<string, string>, urls?: Record<string, string>): Server;
+
+export { type McpContext, createMcpServer };

package/dist/server-factory.js

@@ -0,0 +1,7 @@
+import {
+  createMcpServer
+} from "./chunk-OHTORKDB.js";
+import "./chunk-YDZJAN2U.js";
+export {
+  createMcpServer
+};

package/dist/tools.d.ts

@@ -0,0 +1,12 @@
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+
+/**
+ * MCP Tool Definitions
+ *
+ * All Sly MCP tools extracted for reuse across transports
+ * (stdio for Claude Desktop, HTTP for remote clients like Intercom Fin).
+ */
+
+declare const tools: Tool[];
+
+export { tools };

package/dist/tools.js

@@ -0,0 +1,6 @@
+import {
+  tools
+} from "./chunk-YDZJAN2U.js";
+export {
+  tools
+};

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@sly_ai/mcp-server",
+  "version": "0.1.0",
+  "description": "Model Context Protocol (MCP) server for Sly - enables Claude Desktop integration and remote HTTP access",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./tools": {
+      "import": "./dist/tools.js",
+      "types": "./dist/tools.d.ts"
+    },
+    "./server-factory": {
+      "import": "./dist/server-factory.js",
+      "types": "./dist/server-factory.d.ts"
+    }
+  },
+  "bin": {
+    "sly-mcp-server": "./dist/index.js"
+  },
+  "scripts": {
+    "build": "tsup src/index.ts src/tools.ts src/server-factory.ts --format esm --dts --shims",
+    "dev": "tsup src/index.ts src/tools.ts src/server-factory.ts --format esm --dts --watch --shims",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "start": "node dist/index.js"
+  },
+  "dependencies": {
+    "@sly/sdk": "workspace:*",
+    "@modelcontextprotocol/sdk": "^1.0.4"
+  },
+  "devDependencies": {
+    "@types/node": "^20.14.10",
+    "tsup": "^8.0.0",
+    "typescript": "^5.3.3",
+    "vitest": "^2.0.0"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "claude",
+    "sly",
+    "payments",
+    "ai"
+  ]
+}

package/src/index.test.ts

@@ -0,0 +1,75 @@
+/**
+ * Tests for MCP Server
+ * Note: These are basic tests. Full integration testing requires MCP Inspector.
+ */
+
+import { describe, it, expect } from 'vitest';
+
+describe('MCP Server', () => {
+  it('should be testable', () => {
+    // Basic smoke test
+    expect(true).toBe(true);
+  });
+
+  it('should have required environment variables documented', () => {
+    // Test that environment variables are documented
+    const requiredEnvVars = ['SLY_API_KEY', 'SLY_ENVIRONMENT'];
+    expect(requiredEnvVars).toHaveLength(2);
+  });
+
+  it('should define expected tools', () => {
+    const expectedTools = [
+      // Settlement
+      'get_settlement_quote',
+      'create_settlement',
+      'get_settlement_status',
+      // UCP Checkout
+      'ucp_discover',
+      'ucp_create_checkout',
+      'ucp_get_checkout',
+      'ucp_list_checkouts',
+      'ucp_update_checkout',
+      'ucp_complete_checkout',
+      'ucp_cancel_checkout',
+      'ucp_add_payment_instrument',
+      'ucp_batch_checkout',
+      // UCP Orders
+      'ucp_list_orders',
+      'ucp_get_order',
+      'ucp_update_order_status',
+      'ucp_cancel_order',
+      'ucp_add_fulfillment_event',
+      // Agent Management
+      'list_accounts',
+      'create_agent',
+      'verify_agent',
+      'get_agent',
+      'get_agent_limits',
+      // AP2 Mandates
+      'ap2_create_mandate',
+      'ap2_get_mandate',
+      'ap2_execute_mandate',
+      'ap2_list_mandates',
+      // ACP Checkouts
+      'acp_create_checkout',
+      'acp_get_checkout',
+      'acp_complete_checkout',
+      'acp_list_checkouts',
+      // Wallet Management
+      'list_wallets',
+      'create_wallet',
+      'get_wallet',
+      'get_wallet_balance',
+      'wallet_deposit',
+      'wallet_withdraw',
+      'wallet_test_fund',
+      // x402 Micropayments
+      'x402_create_endpoint',
+      'x402_list_endpoints',
+      'x402_get_endpoint',
+      'x402_pay',
+      'x402_verify',
+    ];
+    expect(expectedTools).toHaveLength(42);
+  });
+});

package/src/index.ts

@@ -0,0 +1,72 @@
+#!/usr/bin/env node
+
+/**
+ * Sly MCP Server — CLI Entry Point
+ *
+ * Model Context Protocol server for Claude Desktop integration.
+ * Exposes Sly payment capabilities as MCP tools via stdio transport.
+ *
+ * Usage:
+ *   npx @sly/mcp-server
+ *
+ * Configuration via environment variables:
+ *   SLY_API_KEY - Your Sly API key (required)
+ *   SLY_ENVIRONMENT - 'sandbox' | 'testnet' | 'production' (default: 'sandbox')
+ */
+
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { Sly, getEnvironmentConfig } from '@sly/sdk';
+import { createMcpServer } from './server-factory.js';
+
+// Re-export for external consumers (e.g., apps/api remote MCP endpoint)
+export { tools } from './tools.js';
+export { createMcpServer } from './server-factory.js';
+export type { McpContext } from './server-factory.js';
+
+// Get configuration from environment
+const SLY_API_KEY = process.env.SLY_API_KEY;
+const SLY_API_KEY_LIVE = process.env.SLY_API_KEY_LIVE;
+const SLY_ENVIRONMENT = (process.env.SLY_ENVIRONMENT as 'sandbox' | 'testnet' | 'production') || 'sandbox';
+
+if (!SLY_API_KEY) {
+  console.error('Error: SLY_API_KEY environment variable is required');
+  process.exit(1);
+}
+
+// Initialize Sly SDK
+const sly = new Sly({
+  apiKey: SLY_API_KEY,
+  environment: SLY_ENVIRONMENT,
+  apiUrl: process.env.SLY_API_URL,
+});
+
+// Derive API URL for direct fetch calls (batch operations)
+const SLY_API_URL = process.env.SLY_API_URL || getEnvironmentConfig(SLY_ENVIRONMENT).apiUrl;
+
+// Build keys map for runtime environment switching
+const keys: Record<string, string> = { sandbox: SLY_API_KEY };
+if (SLY_API_KEY_LIVE) keys.production = SLY_API_KEY_LIVE;
+
+// Build URLs map for runtime environment switching
+const SLY_API_URL_LIVE = process.env.SLY_API_URL_LIVE;
+const urls: Record<string, string> = { sandbox: SLY_API_URL };
+if (SLY_API_URL_LIVE) urls.production = SLY_API_URL_LIVE;
+
+// Create MCP server with all tools
+const server = createMcpServer(sly, SLY_API_URL, SLY_API_KEY, keys, urls);
+
+/**
+ * Start the server
+ */
+async function main() {
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+
+  console.error('Sly MCP server running on stdio');
+  console.error(`Environment: ${SLY_ENVIRONMENT}`);
+}
+
+main().catch((error) => {
+  console.error('Fatal error:', error);
+  process.exit(1);
+});