fix: add token-list fallback and 0x api key support

Author: jarrodwatts

README.md

@@ -126,13 +126,17 @@ npx -y @abstract-foundation/agw-mcp serve --chain-id 2741
 
 # Custom RPC
 npx -y @abstract-foundation/agw-mcp serve --chain-id 2741 --rpc-url https://api.mainnet.abs.xyz
+
+# 0x API key override (for swap_tokens quote requests)
+npx -y @abstract-foundation/agw-mcp serve --chain-id 2741 --zeroex-api-key YOUR_0X_API_KEY
 ```
 
 Environment variables are also supported:
 
 ```bash
 AGW_MCP_CHAIN_ID=2741 npx -y @abstract-foundation/agw-mcp serve
 AGW_MCP_RPC_URL=https://api.mainnet.abs.xyz npx -y @abstract-foundation/agw-mcp serve
+AGW_MCP_ZEROEX_API_KEY=YOUR_0X_API_KEY npx -y @abstract-foundation/agw-mcp serve
 AGW_MCP_APP_URL=https://mcp.abs.xyz npx -y @abstract-foundation/agw-mcp init --chain-id 2741
 ```
 

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@abstract-foundation/agw-mcp",
-  "version": "0.1.0-beta.6",
+  "version": "0.1.0-beta.7",
   "description": "MCP server for Abstract Global Wallet session-key workflows",
   "license": "MIT",
   "author": "Abstract Foundation",

src/config/index.ts

@@ -1 +1,2 @@
 export * from "./network.js";
+export * from "./zeroex.js";

src/config/zeroex.ts

@@ -0,0 +1,39 @@
+const ZEROEX_API_KEY_ENV_KEYS = ["AGW_MCP_ZEROEX_API_KEY", "ZEROEX_API_KEY"] as const;
+
+export interface ResolveZeroExConfigInput {
+  apiKey?: string;
+  env?: NodeJS.ProcessEnv;
+}
+
+export interface ResolvedZeroExConfig {
+  apiKey?: string;
+}
+
+function normalizeOptionalString(value: unknown): string | undefined {
+  if (typeof value !== "string") {
+    return undefined;
+  }
+
+  const normalized = value.trim();
+  return normalized ? normalized : undefined;
+}
+
+function resolveEnvValue(env: NodeJS.ProcessEnv, keys: readonly string[]): string | undefined {
+  for (const key of keys) {
+    const value = normalizeOptionalString(env[key]);
+    if (value) {
+      return value;
+    }
+  }
+
+  return undefined;
+}
+
+export function resolveZeroExConfig(input: ResolveZeroExConfigInput = {}): ResolvedZeroExConfig {
+  const env = input.env ?? process.env;
+  const apiKey = normalizeOptionalString(input.apiKey) ?? resolveEnvValue(env, ZEROEX_API_KEY_ENV_KEYS);
+
+  return {
+    apiKey,
+  };
+}

src/index.ts

@@ -10,6 +10,7 @@ import { SessionManager } from "./session/manager.js";
 import { Logger } from "./utils/logger.js";
 
 const logger = new Logger("agw-mcp");
+const ZEROEX_API_KEY_ENV = "AGW_MCP_ZEROEX_API_KEY";
 
 function resolveCliVersion(): string {
   try {
@@ -25,6 +26,18 @@ function resolveCliVersion(): string {
   return "0.1.0";
 }
 
+function applyZeroExApiKeyOverride(apiKeyValue: unknown): void {
+  if (apiKeyValue === undefined) {
+    return;
+  }
+
+  if (typeof apiKeyValue !== "string" || apiKeyValue.trim() === "") {
+    throw new Error("--zeroex-api-key must be a non-empty string");
+  }
+
+  process.env[ZEROEX_API_KEY_ENV] = apiKeyValue.trim();
+}
+
 const program = new Command();
 program.name("agw-mcp").description("Local MCP server for AGW session-key workflows").version(resolveCliVersion());
 
@@ -77,8 +90,11 @@ program
   .description("Run the local stdio MCP server")
   .option("--chain-id <chainId>", "EVM chain id (env: AGW_MCP_CHAIN_ID)")
   .option("--rpc-url <rpcUrl>", "RPC URL override (env: AGW_MCP_RPC_URL)")
+  .option("--zeroex-api-key <apiKey>", "0x API key override (env: AGW_MCP_ZEROEX_API_KEY)")
   .option("--storage-dir <dir>", "Session storage directory")
   .action(async options => {
+    applyZeroExApiKeyOverride(options.zeroexApiKey);
+
     const networkConfig = resolveNetworkConfig({
       chainId: options.chainId,
       rpcUrl: options.rpcUrl,

src/integrations/zeroex/quote-adapter.ts

@@ -1,3 +1,5 @@
+import { resolveZeroExConfig } from "../../config/zeroex.js";
+
 const DEFAULT_ZEROEX_API_BASE_URL = "https://api.0x.org";
 const DEFAULT_ZEROEX_TIMEOUT_MS = 15_000;
 const INTEGER_AMOUNT_PATTERN = /^[1-9]\d*$/;
@@ -532,4 +534,5 @@ export function createZeroExQuoteAdapter(config: ZeroExQuoteAdapterConfig = {}):
   };
 }
 
-export const zeroExQuoteAdapter = createZeroExQuoteAdapter();
+const defaultZeroExConfig = resolveZeroExConfig();
+export const zeroExQuoteAdapter = createZeroExQuoteAdapter({ apiKey: defaultZeroExConfig.apiKey });