@panoptic-eng/mcp 0.1.33 → 0.1.34

package/README.md

@@ -22,7 +22,7 @@ its MCP settings, etc.).
       "command": "npx",
       "args": ["-y", "@panoptic-eng/mcp"],
       "env": {
-        "PANOPTIC_RPC_URL": "https://eth-mainnet.g.alchemy.com/v2/<key>",
+        "PANOPTIC_RPC_URL": "<RPC URL>",
         "PANOPTIC_CHAIN_ID": "1",
         // optional — enables enhanced analytics tools
         "PANOPTIC_SUBGRAPH_URL": ""
@@ -35,9 +35,16 @@ its MCP settings, etc.).
 Configuration may also be passed as CLI flags, which override the env vars:
 
 ```bash
-npx @panoptic-eng/mcp --rpc-url https://eth-mainnet.g.alchemy.com/v2/<key> --chain-id 1
+npx @panoptic-eng/mcp --rpc-url <RPC URL> --chain-id 1
 ```
 
+`--rpc-url` is used as-is, and existing `PANOPTIC_RPC_URL` setups keep working.
+Without the flag, the RPC resolves from `RPC_URL_<chainId>` (comma-separated
+URLs or provider names, primary first, with optional
+`RPC_HEADERS_<chainId>_<n>` headers), then `PANOPTIC_RPC_URL`, then a provider
+API key (`ALCHEMY_API_KEY`, `UNIBLOCK_API_KEY`, `INFURA_API_KEY`; order set by
+`RPC_PROVIDERS`). See `docs/rpc.md` in the Panoptic monorepo.
+
 Supported chains: Ethereum mainnet (`1`), Sepolia (`11155111`).
 
 ## v0 tools (read-only)
@@ -100,7 +107,7 @@ pnpm --filter @panoptic-eng/mcp typecheck   # tsc --noEmit
 pnpm --filter @panoptic-eng/mcp lint
 
 # Inspect locally against a real RPC:
-PANOPTIC_RPC_URL=https://eth-mainnet.g.alchemy.com/v2/<key> PANOPTIC_CHAIN_ID=1 \
+PANOPTIC_RPC_URL=<RPC URL> PANOPTIC_CHAIN_ID=1 \
   npx @modelcontextprotocol/inspector node dist/cli.js
 ```
 

package/dist/cli.js

@@ -1,6 +1,7 @@
 #!/usr/bin/env node
-import { SERVER_VERSION, createContext, createServer, resolveConfig } from "./server-CabyB7Fb.js";
+import { SERVER_VERSION, createContext, createServer, resolveConfig } from "./server-BBlJn8pL.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { redactRpcSecrets } from "@panoptic-eng/sdk/rpc";
 
 //#region src/cli.ts
 async function main() {
@@ -13,7 +14,7 @@ async function main() {
 }
 main().catch((err) => {
 	const message = err instanceof Error ? err.message : String(err);
-	console.error(`panoptic-mcp failed to start: ${message}`);
+	console.error(`panoptic-mcp failed to start: ${redactRpcSecrets(message)}`);
 	process.exit(1);
 });
 

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 /// <reference types="node" />
+import { RpcEndpoint } from "@panoptic-eng/sdk/rpc";
 import { ChainDeployment } from "@panoptic-eng/sdk/v2";
 import { Address, Hex, PublicClient } from "viem";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
@@ -11,7 +12,10 @@ declare const KNOWN_CHAIN_IDS: readonly [1, 11155111];
  */
 
 interface ServerConfig {
+  /** Primary RPC URL; used alone when `rpcEndpoints` is absent. */
   rpcUrl: string;
+  /** RPC endpoints for `chainId`, primary first, with their credential headers. */
+  rpcEndpoints?: RpcEndpoint[];
   chainId: number;
   /** Optional indexer URL; enables enhanced analytics tools. */
   subgraphUrl?: string;
@@ -38,9 +42,11 @@ interface PanopticContext {
 }
 /**
  * Resolve server config from CLI flags (`--rpc-url`, `--chain-id`,
- * `--subgraph-url`) layered over env (`PANOPTIC_RPC_URL`, `PANOPTIC_CHAIN_ID`,
- * `PANOPTIC_SUBGRAPH_URL`). CLI flags win. Throws a readable error when RPC URL
- * or chain id is missing or unsupported.
+ * `--subgraph-url`) layered over env (`PANOPTIC_CHAIN_ID`,
+ * `PANOPTIC_SUBGRAPH_URL`). CLI flags win. `--rpc-url` is used as-is; otherwise
+ * the RPC resolves from `RPC_URL_<chainId>`, `PANOPTIC_RPC_URL` or a provider
+ * key (docs/rpc.md). Throws a readable error when the RPC or chain id is
+ * missing or unsupported.
  */
 declare function resolveConfig(argv: string[], env: NodeJS.ProcessEnv): ServerConfig;
 /** Create the shared context (viem client + resolved deployment) for tools. */

package/dist/index.js

@@ -1,3 +1,3 @@
-import { KNOWN_CHAIN_IDS, SERVER_NAME, SERVER_VERSION, buildEnvelope, createContext, createServer, jsonResult, resolveConfig, toJsonSafe } from "./server-CabyB7Fb.js";
+import { KNOWN_CHAIN_IDS, SERVER_NAME, SERVER_VERSION, buildEnvelope, createContext, createServer, jsonResult, resolveConfig, toJsonSafe } from "./server-BBlJn8pL.js";
 
 export { KNOWN_CHAIN_IDS, SERVER_NAME, SERVER_VERSION, buildEnvelope, createContext, createServer, jsonResult, resolveConfig, toJsonSafe };

package/dist/{server-CabyB7Fb.js → server-BBlJn8pL.js}

@@ -1,5 +1,6 @@
+import { resolveRpcEndpoints, rpcTransport } from "@panoptic-eng/sdk/rpc";
 import { DEFAULT_VEGOID, MAX_TICK, MIN_TICK, STANDARD_TICK_WIDTHS, WAD, createMemoryStorage, createTokenIdBuilder, decodeTokenId, getAccountBuyingPower, getAccountCollateral, getAccountGreeks, getAccountHistory, getAccountPremia, getChainDeployment, getDeltaHedgeParams, getLegDelta, getMarginBuffer, getNetLiquidationValues, getOpenPositionPreview, getPool, getPoolDeploymentBlock, getPoolLiquidities, getPositions, getTrackedPositionIds, hasLoanOrCredit, hasLongLeg, isCall, isCreditLeg, isLiquidatable, isLoanLeg, isShortOnly, isSpread, roundToTickSpacing, scanChunks, simulateClosePosition, syncPositions, tickToPriceDecimalScaled } from "@panoptic-eng/sdk/v2";
-import { createPublicClient, getAddress, http, isAddress, keccak256, toBytes, toHex } from "viem";
+import { createPublicClient, getAddress, isAddress, keccak256, toBytes, toHex } from "viem";
 import { mainnet, sepolia } from "viem/chains";
 import { createRequire } from "node:module";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
@@ -35,14 +36,14 @@ function resolveChainId(rawChainId, fallback) {
 var ConfigError = class extends Error {};
 /**
 * Resolve server config from CLI flags (`--rpc-url`, `--chain-id`,
-* `--subgraph-url`) layered over env (`PANOPTIC_RPC_URL`, `PANOPTIC_CHAIN_ID`,
-* `PANOPTIC_SUBGRAPH_URL`). CLI flags win. Throws a readable error when RPC URL
-* or chain id is missing or unsupported.
+* `--subgraph-url`) layered over env (`PANOPTIC_CHAIN_ID`,
+* `PANOPTIC_SUBGRAPH_URL`). CLI flags win. `--rpc-url` is used as-is; otherwise
+* the RPC resolves from `RPC_URL_<chainId>`, `PANOPTIC_RPC_URL` or a provider
+* key (docs/rpc.md). Throws a readable error when the RPC or chain id is
+* missing or unsupported.
 */
 function resolveConfig(argv, env) {
 	const flags = parseFlags(argv);
-	const rpcUrl = flags["rpc-url"] ?? env.PANOPTIC_RPC_URL;
-	if (!rpcUrl) throw new ConfigError("Missing RPC URL. Set PANOPTIC_RPC_URL or pass --rpc-url <url>.");
 	const rawChainId = flags["chain-id"] ?? env.PANOPTIC_CHAIN_ID;
 	if (!rawChainId) throw new ConfigError("Missing chain id. Set PANOPTIC_CHAIN_ID or pass --chain-id <id>.");
 	let chainId;
@@ -52,22 +53,42 @@ function resolveConfig(argv, env) {
 		throw new ConfigError(err instanceof Error ? err.message : String(err));
 	}
 	const subgraphUrl = flags["subgraph-url"] ?? env.PANOPTIC_SUBGRAPH_URL ?? void 0;
+	const rpcEndpoints = resolveRpc(flags["rpc-url"], chainId, env);
 	return {
-		rpcUrl,
+		rpcUrl: rpcEndpoints[0].url,
+		rpcEndpoints,
 		chainId,
 		subgraphUrl
 	};
 }
+function resolveRpc(rpcUrlFlag, chainId, env) {
+	if (rpcUrlFlag) return [{
+		source: "url",
+		url: rpcUrlFlag,
+		headers: {}
+	}];
+	try {
+		return resolveRpcEndpoints(chainId, env, { legacyUrlEnv: ["PANOPTIC_RPC_URL"] });
+	} catch (err) {
+		const message = err instanceof Error ? err.message : String(err);
+		if (!message.startsWith("No RPC configured")) throw new ConfigError(message);
+		throw new ConfigError(`Missing RPC URL. ${message}, or pass --rpc-url <url>.`);
+	}
+}
 /** Create the shared context (viem client + resolved deployment) for tools. */
 async function createContext(config) {
 	const deployment = getChainDeployment(config.chainId);
 	if (deployment === void 0) throw new ConfigError(`Unsupported chain id ${config.chainId}`);
 	const client = createPublicClient({
 		chain: VIEM_CHAINS[config.chainId],
-		transport: http(config.rpcUrl)
+		transport: rpcTransport(config.rpcEndpoints ?? [{
+			source: "url",
+			url: config.rpcUrl,
+			headers: {}
+		}])
 	});
 	const rpcChainId = await client.getChainId();
-	if (rpcChainId !== config.chainId) throw new ConfigError(`RPC chain id ${rpcChainId} does not match configured chain id ${config.chainId}. Point PANOPTIC_RPC_URL at a chain-${config.chainId} endpoint or set PANOPTIC_CHAIN_ID to ${rpcChainId}.`);
+	if (rpcChainId !== config.chainId) throw new ConfigError(`RPC chain id ${rpcChainId} does not match configured chain id ${config.chainId}. Point the RPC at a chain-${config.chainId} endpoint or set PANOPTIC_CHAIN_ID to ${rpcChainId}.`);
 	return {
 		config,
 		client,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@panoptic-eng/mcp",
-  "version": "0.1.33",
+  "version": "0.1.34",
   "description": "Local MCP server exposing the Panoptic SDK as read/build/simulate tools for AI agents.",
   "license": "MIT",
   "type": "module",
@@ -35,7 +35,7 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.25.0",
-    "@panoptic-eng/sdk": "^1.0.61",
+    "@panoptic-eng/sdk": "^1.0.62",
     "viem": "^2.41.2",
     "zod": "^4.3.6"
   },