@robosystems/core 0.5.7 → 0.5.9

package/components/console/ConsoleContent.js

@@ -407,6 +407,8 @@ export function ConsoleContent({ config }) {
     };
     const showMcpSetup = async () => {
         addSystemMessage('Creating MCP API key...', true);
+        const apiUrl = process.env.NEXT_PUBLIC_ROBOSYSTEMS_API_URL ||
+            'https://api.robosystems.ai';
         try {
             const { createUserApiKey } = await import('@robosystems/client/sdk');
             const response = await createUserApiKey({
@@ -418,39 +420,45 @@ export function ConsoleContent({ config }) {
                 throw new Error('Failed to create API key');
             }
             const apiKey = response.data.key;
-            const apiUrl = process.env.NEXT_PUBLIC_ROBOSYSTEMS_API_URL ||
-                'https://api.robosystems.ai';
             const { mcp } = config;
+            const contextId = graphId || mcp.contextIdFallback;
+            // The graph id lives in the URL path and never becomes a tool argument,
+            // so one connector is anchored to exactly one graph. Multi-graph users
+            // add one connector per graph, which is why the name carries the id.
+            const mcpUrl = `${apiUrl}/v1/graphs/${contextId}/mcp`;
+            const connectorName = `${mcp.serverName}-${contextId}`;
             const exampleLines = mcp.exampleQuestions
                 .map((q) => `  • "${q}"`)
                 .join('\n');
             addSystemMessage(`MCP Setup Instructions:\n` +
                 `═══════════════════════════════════════════════════════════════\n\n` +
                 `API Key Created Successfully!\n\n` +
-                `Add this configuration to claude_desktop_config.json:\n\n` +
-                `   {\n` +
-                `     "mcpServers": {\n` +
-                `       "${mcp.serverName}": {\n` +
-                `         "command": "npx",\n` +
-                `         "args": ["-y", "${mcp.packageName}@latest"],\n` +
-                `         "env": {\n` +
-                `           "ROBOSYSTEMS_API_URL": "${apiUrl}",\n` +
-                `           "ROBOSYSTEMS_API_KEY": "${apiKey}",\n` +
-                `           "ROBOSYSTEMS_GRAPH_ID": "${graphId || mcp.contextIdFallback}"\n` +
-                `         }\n` +
-                `       }\n` +
-                `     }\n` +
-                `   }\n\n` +
-                `Restart Claude Desktop or Claude Code to apply.\n\n` +
+                `One URL, one header — no install required.\n\n` +
+                `   URL:    ${mcpUrl}\n` +
+                `   Header: X-API-Key: ${apiKey}\n\n` +
+                `Claude (claude.ai / Desktop)\n` +
+                `  Settings → Connectors → Add custom connector, then paste the URL\n` +
+                `  above and add the header.\n\n` +
+                `Claude Code\n` +
+                `  claude mcp add --transport http ${connectorName} \\\n` +
+                `    ${mcpUrl} \\\n` +
+                `    --header "X-API-Key: ${apiKey}"\n\n` +
+                `Cursor / VS Code (mcp.json)\n` +
+                `  "${connectorName}": {\n` +
+                `    "url": "${mcpUrl}",\n` +
+                `    "headers": { "X-API-Key": "${apiKey}" }\n` +
+                `  }\n\n` +
                 `Once connected, ask Claude questions like:\n` +
                 `${exampleLines}\n\n` +
+                `Clients without HTTP transport support can use the legacy stdio\n` +
+                `bridge: https://github.com/RoboFinSystems/robosystems-mcp-client\n\n` +
                 `Keep this API key secure! It has full access to your account.`, true);
         }
         catch (error) {
             addErrorMessage(`Failed to create API key: ${error.message || 'Unknown error'}\n\n` +
-                `You can manually create an API key in Settings and use it with:\n` +
-                `  ROBOSYSTEMS_API_URL: https://api.robosystems.ai\n` +
-                `  ROBOSYSTEMS_GRAPH_ID: ${graphId || config.mcp.contextIdFallback}`);
+                `You can create an API key in Settings and connect with:\n` +
+                `  URL:    ${apiUrl}/v1/graphs/${graphId || config.mcp.contextIdFallback}/mcp\n` +
+                `  Header: X-API-Key: <your key>`);
         }
     };
     const handleCommand = async (command) => {

package/components/console/graphAwareConfig.d.ts

@@ -35,7 +35,9 @@ export declare const EXAMPLE_SETS: Record<GraphExampleKind, GraphExampleSet>;
  * @param preferredKind Tiebreak used only when a graph carries more than one
  *   entity extension (e.g. both roboledger and roboinvestor). Pass the app's
  *   own lens (a RoboLedger app passes 'roboledger') so a dual-extension graph
- *   shows the examples that fit the app the user is in.
+ *   shows the examples that fit the app the user is in. With no lens — the
+ *   brand-neutral RoboSystems console — a graph carrying the roboledger schema
+ *   gets ledger examples, never portfolio ones.
  */
 export declare function getGraphExampleKind(graph: GraphInfo | undefined, preferredKind?: GraphExampleKind): GraphExampleKind;
 /** App-specific branding merged with the graph-derived example set. */
@@ -50,7 +52,8 @@ export interface ConsoleBranding {
     closingMessage: string;
     mcp: {
         serverName: string;
-        packageName: string;
+        /** @deprecated Unused since the remote MCP transport landed. */
+        packageName?: string;
         contextIdFallback: string;
     };
     /** Defaults to "Example Cypher Queries:". */

package/components/console/graphAwareConfig.js

@@ -333,7 +333,9 @@ export const EXAMPLE_SETS = {
  * @param preferredKind Tiebreak used only when a graph carries more than one
  *   entity extension (e.g. both roboledger and roboinvestor). Pass the app's
  *   own lens (a RoboLedger app passes 'roboledger') so a dual-extension graph
- *   shows the examples that fit the app the user is in.
+ *   shows the examples that fit the app the user is in. With no lens — the
+ *   brand-neutral RoboSystems console — a graph carrying the roboledger schema
+ *   gets ledger examples, never portfolio ones.
  */
 export function getGraphExampleKind(graph, preferredKind) {
     var _a;
@@ -347,7 +349,7 @@ export function getGraphExampleKind(graph, preferredKind) {
     if (hasInvestor && hasLedger) {
         return preferredKind === 'roboledger' || preferredKind === 'roboinvestor'
             ? preferredKind
-            : 'roboinvestor';
+            : 'roboledger';
     }
     if (hasInvestor)
         return 'roboinvestor';

package/components/console/types.d.ts

@@ -27,10 +27,15 @@ export interface ConsoleHeaderConfig {
     gradientTo: string;
 }
 export interface ConsoleMcpConfig {
-    /** MCP server name in the JSON config, e.g. "robosystems" */
+    /** Connector name prefix, e.g. "robosystems". The graph id is appended, so
+     *  each of a user's graphs gets a distinctly named connector. */
     serverName: string;
-    /** npm package name, e.g. "@robosystems/mcp" */
-    packageName: string;
+    /**
+     * @deprecated Unused since the remote MCP transport landed — `/mcp` now emits
+     * a URL + `X-API-Key` header instead of an npx stdio config. Kept optional so
+     * consuming apps can drop it on their own schedule.
+     */
+    packageName?: string;
     /** Example questions shown after MCP setup */
     exampleQuestions: string[];
     /** Fallback text for graph ID placeholder, e.g. "your_graph_id" */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@robosystems/core",
-  "version": "0.5.7",
+  "version": "0.5.9",
   "description": "Shared RoboSystems frontend core library (auth, contexts, task monitoring, UI components) for the RoboSystems Next.js apps",
   "license": "MIT",
   "private": false,
@@ -27,7 +27,7 @@
     "tailwind-merge": "^3"
   },
   "peerDependencies": {
-    "@robosystems/client": ">=0.6.2 <1",
+    "@robosystems/client": ">=0.6.2 <2",
     "flowbite-react": "^0.12.5",
     "next": ">=15 <17",
     "react": ">=18 <20",