@oobe-protocol-labs/sap-mcp-server 0.1.0

package/config.schema.json

@@ -0,0 +1,370 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "SAP MCP Configuration",
+  "description": "Profile-managed configuration schema for SAP MCP Server.",
+  "type": "object",
+  "additionalProperties": false,
+  "properties": {
+    "$schema": {
+      "type": "string"
+    },
+    "_comment": {
+      "type": "string"
+    },
+    "_docs": {
+      "type": "string"
+    },
+    "_version": {
+      "type": "string"
+    },
+    "mode": {
+      "type": "string",
+      "enum": ["readonly", "local-dev-keypair", "external-signer", "delegated-session", "hosted-api"],
+      "default": "readonly",
+      "description": "Server operating mode."
+    },
+    "rpcUrl": {
+      "type": "string",
+      "format": "uri",
+      "default": "https://api.mainnet-beta.solana.com",
+      "description": "Primary Solana RPC endpoint."
+    },
+    "rpcUrlDevnet": {
+      "type": "string",
+      "format": "uri"
+    },
+    "rpcUrlTestnet": {
+      "type": "string",
+      "format": "uri"
+    },
+    "programId": {
+      "type": "string",
+      "default": "SAPpUhsWLJG1FfkGRcXagEDMrMsWGjbky7AyhGpFETZ",
+      "description": "SAP Protocol program ID."
+    },
+    "commitment": {
+      "type": "string",
+      "enum": ["processed", "confirmed", "finalized"],
+      "default": "confirmed"
+    },
+    "agentPubkey": {
+      "type": "string",
+      "description": "Public key associated with the SAP MCP profile signer."
+    },
+    "maxRetries": {
+      "type": "integer",
+      "minimum": 1,
+      "default": 3
+    },
+    "retryDelayMs": {
+      "type": "integer",
+      "minimum": 1,
+      "default": 1000
+    },
+    "walletPath": {
+      "type": "string",
+      "description": "Dedicated profile wallet path. Do not point this at the Solana CLI keypair unless explicitly intended."
+    },
+    "walletEncrypted": {
+      "type": "boolean",
+      "default": false
+    },
+    "walletPassphraseEnv": {
+      "type": "string"
+    },
+    "externalSignerUrl": {
+      "type": "string",
+      "format": "uri"
+    },
+    "externalSignerTimeoutMs": {
+      "type": "integer",
+      "minimum": 1,
+      "default": 30000
+    },
+    "enableHttp": {
+      "type": "boolean",
+      "default": false
+    },
+    "httpPort": {
+      "type": "integer",
+      "minimum": 1,
+      "maximum": 65535,
+      "default": 8787
+    },
+    "httpHost": {
+      "type": "string",
+      "default": "127.0.0.1"
+    },
+    "httpCorsOrigins": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "maxTxValueSol": {
+      "type": "number",
+      "minimum": 0,
+      "default": 10
+    },
+    "requireApprovalAboveSol": {
+      "type": "number",
+      "minimum": 0,
+      "default": 1
+    },
+    "dailyLimitSol": {
+      "type": "number",
+      "minimum": 0,
+      "default": 100
+    },
+    "allowedTools": {
+      "oneOf": [
+        {
+          "const": "all"
+        },
+        {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        }
+      ],
+      "default": "all"
+    },
+    "logLevel": {
+      "type": "string",
+      "enum": ["debug", "info", "warn", "error"],
+      "default": "info"
+    },
+    "logFormat": {
+      "type": "string",
+      "enum": ["json", "pretty"],
+      "default": "pretty"
+    },
+    "logFile": {
+      "type": "string"
+    },
+    "enableMetrics": {
+      "type": "boolean",
+      "default": false
+    },
+    "metricsPort": {
+      "type": "integer",
+      "minimum": 1,
+      "maximum": 65535,
+      "default": 9090
+    },
+    "enableCache": {
+      "type": "boolean",
+      "default": true
+    },
+    "cacheTtlSeconds": {
+      "type": "integer",
+      "minimum": 1,
+      "default": 300
+    },
+    "enableRateLimit": {
+      "type": "boolean",
+      "default": true
+    },
+    "rateLimitPerMinute": {
+      "type": "integer",
+      "minimum": 1,
+      "default": 60
+    },
+    "$security": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "requireApprovalFor": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "_comment": {
+          "type": "string"
+        },
+        "approvalTimeout": {
+          "type": "integer",
+          "minimum": 1
+        },
+        "maxChangesPerDay": {
+          "type": "integer",
+          "minimum": 1
+        },
+        "requireMultiSig": {
+          "type": "boolean"
+        },
+        "multiSigThreshold": {
+          "type": "integer",
+          "minimum": 1
+        },
+        "multiSigApprovers": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        }
+      }
+    },
+    "$audit": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "enabled": {
+          "type": "boolean"
+        },
+        "_comment": {
+          "type": "string"
+        },
+        "logPath": {
+          "type": "string"
+        },
+        "retentionDays": {
+          "type": "integer",
+          "minimum": 1
+        },
+        "submitToOracle": {
+          "type": "boolean"
+        },
+        "oracleEndpoint": {
+          "type": "string"
+        }
+      }
+    },
+    "bento": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "enabled": {
+          "type": "boolean"
+        },
+        "apiKey": {
+          "type": "string"
+        },
+        "agentId": {
+          "type": "string"
+        },
+        "endpoint": {
+          "type": "string",
+          "format": "uri"
+        }
+      }
+    },
+    "policy": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "mode": {
+          "type": "string",
+          "enum": ["local-only", "bento-only", "hybrid"]
+        },
+        "failOpen": {
+          "type": "boolean"
+        },
+        "logging": {
+          "type": "boolean"
+        }
+      }
+    },
+    "monetization": {
+      "type": "object",
+      "additionalProperties": false,
+      "description": "Optional hosted HTTP monetization through x402 with pay.sh checkout metadata.",
+      "properties": {
+        "enabled": {
+          "type": "boolean",
+          "default": false
+        },
+        "provider": {
+          "type": "string",
+          "enum": ["x402", "pay-sh"],
+          "default": "x402"
+        },
+        "payTo": {
+          "type": "string",
+          "description": "Solana payment recipient for x402 settlement."
+        },
+        "network": {
+          "type": "string",
+          "description": "Optional CAIP-2 Solana network override, e.g. solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp."
+        },
+        "facilitatorUrl": {
+          "type": "string",
+          "format": "uri",
+          "description": "Required when monetization is enabled. Use the OOBE hosted facilitator or a self-hosted sap-mcp-facilitator URL."
+        },
+        "facilitatorAuthToken": {
+          "type": "string"
+        },
+        "maxTimeoutSeconds": {
+          "type": "integer",
+          "minimum": 1,
+          "default": 120
+        },
+        "payShCheckoutUrl": {
+          "type": "string",
+          "format": "uri",
+          "description": "Optional pay.sh checkout URL included in 402 response bodies."
+        },
+        "prices": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "readPremiumUsd": {
+              "type": "number",
+              "exclusiveMinimum": 0,
+              "default": 0.008
+            },
+            "builderUsd": {
+              "type": "number",
+              "exclusiveMinimum": 0,
+              "default": 0.05
+            },
+            "valueFixedUsd": {
+              "type": "number",
+              "minimum": 0,
+              "default": 0.2
+            },
+            "valueBps": {
+              "type": "number",
+              "minimum": 0,
+              "default": 50
+            },
+            "minUsd": {
+              "type": "number",
+              "minimum": 0,
+              "default": 0.001
+            },
+            "maxUsd": {
+              "type": "number",
+              "exclusiveMinimum": 0,
+              "default": 100
+            }
+          }
+        }
+      }
+    },
+    "$meta": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "version": {
+          "type": "string"
+        },
+        "createdAt": {
+          "type": "string",
+          "format": "date-time"
+        },
+        "updatedAt": {
+          "type": "string",
+          "format": "date-time"
+        },
+        "lastHash": {
+          "type": "string"
+        }
+      }
+    }
+  },
+  "required": ["mode", "rpcUrl", "programId", "commitment"]
+}

package/config.secure-example.json

@@ -0,0 +1,100 @@
+{
+  "$schema": "https://raw.githubusercontent.com/oobe-protocol-labs/sap-mcp-server/main/config.schema.json",
+  
+  "_comment": "SAP MCP Server - Secure JSON Configuration",
+  "_docs": "https://github.com/oobe-protocol-labs/sap-mcp-server/blob/main/docs/CONFIGURATION.md",
+  "_version": "1.0.0",
+  
+  "mode": "readonly",
+  "rpcUrl": "https://api.mainnet-beta.solana.com",
+  "rpcUrlDevnet": "https://api.devnet.solana.com",
+  "rpcUrlTestnet": "https://api.testnet.solana.com",
+  "programId": "SAPpUhsWLJG1FfkGRcXagEDMrMsWGjbky7AyhGpFETZ",
+  "commitment": "confirmed",
+  
+  "maxRetries": 3,
+  "retryDelayMs": 1000,
+  
+  "walletPath": "~/.config/mcp-sap/keypairs/dev-wallet-keypair.json",
+  "walletEncrypted": false,
+  "walletPassphraseEnv": "WALLET_PASSPHRASE",
+  
+  "externalSignerUrl": "https://signer.example.com/api/v1/sign",
+  "externalSignerTimeoutMs": 30000,
+  
+  "enableHttp": false,
+  "httpPort": 8787,
+  "httpHost": "127.0.0.1",
+  "httpCorsOrigins": [
+    "https://app.example.com",
+    "https://admin.example.com"
+  ],
+  
+  "maxTxValueSol": 10,
+  "requireApprovalAboveSol": 1,
+  "dailyLimitSol": 100,
+  "allowedTools": "all",
+  
+  "logLevel": "info",
+  "logFormat": "pretty",
+  "logFile": "~/.local/share/mcp-sap/logs/sap-mcp.log",
+  
+  "enableMetrics": false,
+  "metricsPort": 9090,
+  
+  "enableCache": true,
+  "cacheTtlSeconds": 300,
+  "enableRateLimit": true,
+  "rateLimitPerMinute": 60,
+
+  "monetization": {
+    "enabled": false,
+    "provider": "x402",
+    "payTo": "YOUR_SOLANA_USDC_RECIPIENT",
+    "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
+    "facilitatorUrl": "https://x402.oobeprotocol.ai/facilitator",
+    "maxTimeoutSeconds": 120,
+    "payShCheckoutUrl": "https://pay.sh/checkout/YOUR_CHECKOUT_ID",
+    "prices": {
+      "readPremiumUsd": 0.008,
+      "builderUsd": 0.05,
+      "valueFixedUsd": 0.2,
+      "valueBps": 50,
+      "minUsd": 0.001,
+      "maxUsd": 100
+    }
+  },
+  
+  "$security": {
+    "_comment": "Fields that require approval before changing",
+    "requireApprovalFor": [
+      "mode",
+      "walletPath",
+      "externalSignerUrl",
+      "maxTxValueSol",
+      "requireApprovalAboveSol",
+      "dailyLimitSol"
+    ],
+    "approvalTimeout": 300,
+    "maxChangesPerDay": 10,
+    "requireMultiSig": false,
+    "multiSigThreshold": 2,
+    "multiSigApprovers": []
+  },
+  
+  "$audit": {
+    "_comment": "Audit trail configuration",
+    "enabled": true,
+    "logPath": "~/.local/share/mcp-sap/audit.jsonl",
+    "retentionDays": 90,
+    "submitToOracle": false,
+    "oracleEndpoint": ""
+  },
+  
+  "$meta": {
+    "version": "1.0.0",
+    "createdAt": "2026-06-23T10:00:00.000Z",
+    "updatedAt": "2026-06-23T10:00:00.000Z",
+    "lastHash": "auto-generated-on-save"
+  }
+}

package/dist/adapters/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Adapters - Export all adapter modules
+ */
+export * from './mcp/index.js';
+export * from './solana/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/adapters/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/adapters/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC"}

package/dist/adapters/index.js

@@ -0,0 +1,6 @@
+/**
+ * Adapters - Export all adapter modules
+ */
+export * from './mcp/index.js';
+export * from './solana/index.js';
+//# sourceMappingURL=index.js.map

package/dist/adapters/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/adapters/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC"}

package/dist/adapters/mcp/errors.d.ts

@@ -0,0 +1,7 @@
+/**
+ * MCP error helper
+ */
+export declare class McpError extends Error {
+    constructor(message: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/adapters/mcp/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/adapters/mcp/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,qBAAa,QAAS,SAAQ,KAAK;gBACrB,OAAO,EAAE,MAAM;CAI5B"}

package/dist/adapters/mcp/errors.js

@@ -0,0 +1,10 @@
+/**
+ * MCP error helper
+ */
+export class McpError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'McpError';
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/adapters/mcp/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/adapters/mcp/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,OAAO,QAAS,SAAQ,KAAK;IACjC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;IACzB,CAAC;CACF"}

package/dist/adapters/mcp/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * MCP adapter barrel export
+ */
+export { createTextResponse, createJsonResponse, createErrorResponse } from './tool-response.js';
+export { createResourceResponse } from './resource-response.js';
+export { createPromptResponse } from './prompt-response.js';
+export { McpError } from './errors.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/adapters/mcp/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/adapters/mcp/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACjG,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC"}

package/dist/adapters/mcp/index.js

@@ -0,0 +1,8 @@
+/**
+ * MCP adapter barrel export
+ */
+export { createTextResponse, createJsonResponse, createErrorResponse } from './tool-response.js';
+export { createResourceResponse } from './resource-response.js';
+export { createPromptResponse } from './prompt-response.js';
+export { McpError } from './errors.js';
+//# sourceMappingURL=index.js.map

package/dist/adapters/mcp/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/adapters/mcp/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACjG,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC"}

package/dist/adapters/mcp/prompt-response.d.ts

@@ -0,0 +1,13 @@
+/**
+ * MCP prompt response helper.
+ */
+export declare function createPromptResponse(messages: Array<{
+    role: string;
+    content: string;
+}>): {
+    messages: Array<{
+        role: string;
+        content: string;
+    }>;
+};
+//# sourceMappingURL=prompt-response.d.ts.map

package/dist/adapters/mcp/prompt-response.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-response.d.ts","sourceRoot":"","sources":["../../../src/adapters/mcp/prompt-response.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,GAAG;IAAE,QAAQ,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAE/I"}

package/dist/adapters/mcp/prompt-response.js

@@ -0,0 +1,7 @@
+/**
+ * MCP prompt response helper.
+ */
+export function createPromptResponse(messages) {
+    return { messages };
+}
+//# sourceMappingURL=prompt-response.js.map

package/dist/adapters/mcp/prompt-response.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-response.js","sourceRoot":"","sources":["../../../src/adapters/mcp/prompt-response.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,UAAU,oBAAoB,CAAC,QAAkD;IACrF,OAAO,EAAE,QAAQ,EAAE,CAAC;AACtB,CAAC"}

package/dist/adapters/mcp/resource-response.d.ts

@@ -0,0 +1,8 @@
+/**
+ * MCP resource response helper.
+ */
+export declare function createResourceResponse(uri: string, data: string): {
+    uri: string;
+    text: string;
+};
+//# sourceMappingURL=resource-response.d.ts.map

package/dist/adapters/mcp/resource-response.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-response.d.ts","sourceRoot":"","sources":["../../../src/adapters/mcp/resource-response.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAE/F"}

package/dist/adapters/mcp/resource-response.js

@@ -0,0 +1,7 @@
+/**
+ * MCP resource response helper.
+ */
+export function createResourceResponse(uri, data) {
+    return { uri, text: data };
+}
+//# sourceMappingURL=resource-response.js.map

package/dist/adapters/mcp/resource-response.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-response.js","sourceRoot":"","sources":["../../../src/adapters/mcp/resource-response.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,UAAU,sBAAsB,CAAC,GAAW,EAAE,IAAY;IAC9D,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;AAC7B,CAAC"}