@nirholas/bnbchain-mcp 1.0.0

package/build/vendors/tatum-api/utils/chains.js

@@ -0,0 +1,160 @@
+"use strict";
+/**
+ * @author Nich
+ * @website x.com/nichxbt
+ * @github github.com/nirholas
+ * @license MIT
+ */
+/**
+ * Chain protocol mapping utility
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.chainApiConfigs = exports.chainProtocolMap = void 0;
+exports.getChainProtocol = getChainProtocol;
+exports.isRestChain = isRestChain;
+exports.isJsonRpcChain = isJsonRpcChain;
+exports.getSupportedChains = getSupportedChains;
+exports.getChainApiConfig = getChainApiConfig;
+exports.getChainsByProtocol = getChainsByProtocol;
+exports.chainProtocolMap = {
+    // REST-based chains
+    'ton-mainnet': 'rest',
+    'ton-testnet': 'rest',
+    'stellar-mainnet': 'rest',
+    'stellar-testnet': 'rest',
+    'algorand-mainnet': 'rest',
+    'algorand-testnet': 'rest',
+    'cardano-mainnet': 'rest',
+    'cardano-testnet': 'rest',
+    'flow-mainnet': 'rest',
+    'flow-testnet': 'rest',
+    'kadena-mainnet': 'rest',
+    'kadena-testnet': 'rest',
+    'tezos-mainnet': 'rest',
+    'tezos-testnet': 'rest',
+    'vechain-mainnet': 'rest',
+    'vechain-testnet': 'rest',
+    // JSON-RPC based chains
+    'ethereum-mainnet': 'jsonrpc',
+    'ethereum-sepolia': 'jsonrpc',
+    'ethereum-holesky': 'jsonrpc',
+    'polygon-mainnet': 'jsonrpc',
+    'polygon-amoy': 'jsonrpc',
+    'bsc-mainnet': 'jsonrpc',
+    'bsc-testnet': 'jsonrpc',
+    'avalanche-mainnet': 'jsonrpc',
+    'avalanche-testnet': 'jsonrpc',
+    'fantom-mainnet': 'jsonrpc',
+    'fantom-testnet': 'jsonrpc',
+    'celo-mainnet': 'jsonrpc',
+    'celo-testnet': 'jsonrpc',
+    'cronos-mainnet': 'jsonrpc',
+    'cronos-testnet': 'jsonrpc',
+    'klaytn-mainnet': 'jsonrpc',
+    'klaytn-testnet': 'jsonrpc',
+    'flare-mainnet': 'jsonrpc',
+    'flare-testnet': 'jsonrpc',
+    'haqq-mainnet': 'jsonrpc',
+    'haqq-testnet': 'jsonrpc',
+    'arbitrum-mainnet': 'jsonrpc',
+    'arbitrum-testnet': 'jsonrpc',
+    'optimism-mainnet': 'jsonrpc',
+    'optimism-testnet': 'jsonrpc',
+    'base-mainnet': 'jsonrpc',
+    'base-testnet': 'jsonrpc',
+    'bitcoin-mainnet': 'jsonrpc',
+    'bitcoin-testnet': 'jsonrpc',
+    'litecoin-mainnet': 'jsonrpc',
+    'litecoin-testnet': 'jsonrpc',
+    'dogecoin-mainnet': 'jsonrpc',
+    'dogecoin-testnet': 'jsonrpc',
+    'zcash-mainnet': 'jsonrpc',
+    'zcash-testnet': 'jsonrpc',
+    'solana-mainnet': 'jsonrpc',
+    'solana-testnet': 'jsonrpc',
+    'tron-mainnet': 'jsonrpc',
+    'tron-testnet': 'jsonrpc'
+};
+/**
+ * Chain-specific API configurations
+ */
+exports.chainApiConfigs = {
+    'cardano-mainnet': {
+        basePathPrefix: '/api/v0',
+        defaultEndpoints: ['/blocks/latest', '/epochs/latest', '/network'],
+        errorHandling: 'strict',
+        responseFormat: 'json'
+    },
+    'cardano-testnet': {
+        basePathPrefix: '/api/v0',
+        defaultEndpoints: ['/blocks/latest', '/epochs/latest', '/network'],
+        errorHandling: 'strict',
+        responseFormat: 'json'
+    },
+    'flow-mainnet': {
+        basePathPrefix: '/v1',
+        defaultEndpoints: ['/blocks', '/network/parameters', '/node/version_info'],
+        errorHandling: 'lenient',
+        responseFormat: 'json'
+    },
+    'flow-testnet': {
+        basePathPrefix: '/v1',
+        defaultEndpoints: ['/blocks', '/network/parameters', '/node/version_info'],
+        errorHandling: 'lenient',
+        responseFormat: 'json'
+    },
+    'kadena-mainnet': {
+        basePathPrefix: '/chainweb/0.0/mainnet01',
+        defaultEndpoints: ['/config', '/cut', '/chain/0/header'],
+        errorHandling: 'lenient',
+        responseFormat: 'json'
+    },
+    'kadena-testnet': {
+        basePathPrefix: '/chainweb/0.0/testnet04',
+        defaultEndpoints: ['/config', '/cut', '/chain/0/header'],
+        errorHandling: 'lenient',
+        responseFormat: 'json'
+    }
+};
+/**
+ * Get the protocol type for a given chain
+ */
+function getChainProtocol(chainName) {
+    return exports.chainProtocolMap[chainName];
+}
+/**
+ * Check if a chain uses REST protocol
+ */
+function isRestChain(chainName) {
+    return exports.chainProtocolMap[chainName] === 'rest';
+}
+/**
+ * Check if a chain uses JSON-RPC protocol
+ */
+function isJsonRpcChain(chainName) {
+    return exports.chainProtocolMap[chainName] === 'jsonrpc';
+}
+/**
+ * Get all supported chain names
+ */
+function getSupportedChains() {
+    return Object.keys(exports.chainProtocolMap);
+}
+/**
+ * Get API configuration for a specific chain
+ */
+function getChainApiConfig(chainName) {
+    return exports.chainApiConfigs[chainName] || {
+        errorHandling: 'lenient',
+        responseFormat: 'json'
+    };
+}
+/**
+ * Get chains by protocol type
+ */
+function getChainsByProtocol(protocol) {
+    return Object.entries(exports.chainProtocolMap)
+        .filter(([, proto]) => proto === protocol)
+        .map(([chain]) => chain);
+}
+//# sourceMappingURL=chains.js.map

package/build/vendors/tatum-api/utils/chains.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chains.js","sourceRoot":"","sources":["../../../../src/vendors/tatum-api/utils/chains.ts"],"names":[],"mappings":"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"}

package/build/vendors/usdc/index.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.d.ts.map

package/build/vendors/usdc/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/vendors/usdc/index.ts"],"names":[],"mappings":""}

package/build/vendors/usdc/index.js

@@ -0,0 +1,269 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+!/usr/bin / env;
+node;
+const index_js_1 = require("@modelcontextprotocol/sdk/server/index.js");
+const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
+const types_js_1 = require("@modelcontextprotocol/sdk/types.js");
+const zod_1 = require("zod");
+const fs = __importStar(require("fs/promises"));
+const viem_1 = require("viem");
+const chains_1 = require("viem/chains");
+const ensjs_1 = require("@ensdomains/ensjs");
+const coinbase_sdk_1 = require("@coinbase/coinbase-sdk");
+const ethers_1 = require("ethers");
+// import { bootstrap } from 'global-agent';
+// process.env.GLOBAL_AGENT_HTTP_PROXY = 'http://127.0.0.1:10080';
+// process.env.GLOBAL_AGENT_HTTPS_PROXY = 'http://127.0.0.1:10080';
+// process.env.GLOBAL_AGENT_NO_PROXY = 'localhost,127.0.0.1';
+// bootstrap();
+// Base scan
+const BASE_SCAN_ADDR = "https://basescan.org/address/";
+// Check for API key
+const COINBASE_CDP_API_KEY_NAME = process.env.COINBASE_CDP_API_KEY_NAME;
+if (!COINBASE_CDP_API_KEY_NAME) {
+    console.error("Error: COINBASE_CDP_API_KEY_NAME environment variable is required");
+    process.exit(1);
+}
+const COINBASE_CDP_PRIVATE_KEY = process.env.COINBASE_CDP_PRIVATE_KEY;
+if (!COINBASE_CDP_PRIVATE_KEY) {
+    console.error("Error: COINBASE_CDP_SECRET environment variable is required");
+    process.exit(1);
+}
+coinbase_sdk_1.Coinbase.configure({ apiKeyName: COINBASE_CDP_API_KEY_NAME, privateKey: COINBASE_CDP_PRIVATE_KEY });
+// Store
+const os_1 = __importDefault(require("os"));
+const path_1 = __importDefault(require("path"));
+const homeDir = os_1.default.homedir();
+const documentsDir = path_1.default.join(homeDir, 'Documents');
+const seedFilePath = path_1.default.join(documentsDir, "mpc_info.json");
+// Create server instance
+const server = new index_js_1.Server({
+    name: "free-usdc-transfer",
+    version: "0.1.3",
+}, {
+    capabilities: {
+        tools: {},
+    },
+});
+// Define Zod schemas for validation
+const BstsArgumentsSchema = zod_1.z.object({
+    usdc_amount: zod_1.z.number().gt(0),
+    recipient: zod_1.z.string()
+});
+// List available tools
+server.setRequestHandler(types_js_1.ListToolsRequestSchema, async () => {
+    return {
+        tools: [
+            {
+                name: "tranfer-usdc",
+                description: "Analyze the value of the purchased items and transfer USDC to the recipient via the Base chain. Due to the uncertainty of blockchain transaction times, the transaction is only scheduled here and will not wait for the transaction to be completed.",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        usdc_amount: {
+                            type: "number",
+                            description: "USDC amount, greater than 0",
+                        },
+                        recipient: {
+                            type: "string",
+                            description: "Recipient's on-chain address or ENS addresses ending in .eth",
+                        }
+                    },
+                    required: ["usdc_amount", "recipient"],
+                },
+            },
+            {
+                name: "create_coinbase_mpc_wallet",
+                description: "Used to create your Coinbase MPC wallet address. The newly created wallet cannot be used directly; the user must first deposit USDC. The transfer after creation requires user confirmation",
+                inputSchema: {
+                    type: "object"
+                },
+            }
+        ],
+    };
+});
+// Create the client
+const client = (0, ensjs_1.createEnsPublicClient)({
+    chain: chains_1.mainnet,
+    transport: (0, viem_1.http)(),
+});
+// ENS
+async function getAddress(recipient) {
+    if (recipient.toLowerCase().endsWith('.eth')) {
+        return (await client.getAddressRecord({ name: recipient }))?.value;
+    }
+    if (!recipient || recipient.length != 42) {
+        return undefined;
+    }
+    return recipient;
+}
+;
+async function createMPCWallet() {
+    let wallet = await coinbase_sdk_1.Wallet.create({ networkId: "base-mainnet" });
+    wallet.saveSeedToFile(seedFilePath);
+    return (await wallet.getDefaultAddress()).getId();
+}
+async function sendUSDCUseMPCWallet(walletId, recipientAddr, amount) {
+    const wallet = await coinbase_sdk_1.Wallet.fetch(walletId);
+    await wallet.loadSeedFromFile(seedFilePath);
+    const defaultAddress = await wallet.getDefaultAddress();
+    await defaultAddress.createTransfer({
+        amount: amount,
+        assetId: coinbase_sdk_1.Coinbase.assets.Usdc,
+        destination: ethers_1.ethers.getAddress(recipientAddr),
+        gasless: true
+    });
+    return defaultAddress.getId();
+}
+async function queryMpcWallet() {
+    try {
+        const jsonString = await fs.readFile(seedFilePath, 'utf8');
+        const ids = Object.keys(JSON.parse(jsonString));
+        if (!ids || ids.length === 0) {
+            return { mpcAddress: "", mpcId: "" };
+        }
+        const wallet = await coinbase_sdk_1.Wallet.fetch(ids[0]);
+        await wallet.loadSeedFromFile(seedFilePath);
+        return { mpcAddress: (await wallet.getDefaultAddress()).getId(), mpcId: ids[0] };
+    }
+    catch (err) {
+        console.error(`${err}`);
+        return { mpcAddress: "", mpcId: "" };
+    }
+}
+async function queryMpcWalletId() {
+    try {
+        const jsonString = await fs.readFile(seedFilePath, 'utf8');
+        const ids = Object.keys(JSON.parse(jsonString));
+        if (!ids || ids.length === 0) {
+            return "";
+        }
+        return ids[0];
+    }
+    catch (err) {
+        console.error(`${err}`);
+        return "";
+    }
+}
+// Handle tool execution
+server.setRequestHandler(types_js_1.CallToolRequestSchema, async (request) => {
+    const { name, arguments: args } = request.params;
+    try {
+        if (name === "tranfer-usdc") {
+            const { usdc_amount, recipient } = BstsArgumentsSchema.parse(args);
+            const mpcId = await queryMpcWalletId();
+            if (!mpcId) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: "You haven't created a Coinbase MPC wallet yet",
+                        },
+                    ],
+                };
+            }
+            const recipientAddr = await getAddress(recipient);
+            if (!recipientAddr) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: 'Invalid address or ENS',
+                        },
+                    ]
+                };
+            }
+            const addr = await sendUSDCUseMPCWallet(mpcId, recipientAddr, usdc_amount);
+            const linkAddr = BASE_SCAN_ADDR + addr + "#tokentxns";
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `The transaction (sending ${usdc_amount} USDC to ${recipientAddr}) has been scheduled on the Base chain. You can view the details via the link: ${linkAddr}`,
+                    },
+                ],
+            };
+        }
+        else if (name === "create_coinbase_mpc_wallet") {
+            const { mpcAddress } = await queryMpcWallet();
+            if (!mpcAddress) {
+                const newMpcAddress = await createMPCWallet();
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `Your Coinbase MPC wallet address has been successfully created (${newMpcAddress}). Now please transfer USDC to MPC wallet, and you can later use it to transfer funds to others without fees.`,
+                        },
+                    ],
+                };
+            }
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `You already have an address, which is ${mpcAddress}`,
+                    },
+                ],
+            };
+        }
+        else {
+            throw new Error(`Unknown tool: ${name}`);
+        }
+    }
+    catch (error) {
+        if (error instanceof zod_1.z.ZodError) {
+            throw new Error(`Invalid arguments: ${error.errors
+                .map((e) => `${e.path.join(".")}: ${e.message}`)
+                .join(", ")}`);
+        }
+        throw error;
+    }
+});
+// Start the server
+async function main() {
+    const transport = new stdio_js_1.StdioServerTransport();
+    await server.connect(transport);
+    console.error("Universal Crypto MCP running on stdio");
+}
+main().catch((error) => {
+    console.error("Fatal error in main():", error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/build/vendors/usdc/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/vendors/usdc/index.ts"],"names":[],"mappings":"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"}

package/docs/SESSION_SUMMARY_2026-01-20.md

@@ -0,0 +1,216 @@
+# Development Session Summary - January 20, 2026
+
+## Overview
+
+This document summarizes the major development work completed on January 20, 2026, including new MCP servers, refactoring, and documentation.
+
+---
+
+## 1. Binance MCP Server (binance-mcp-server)
+
+### What Was Created
+A comprehensive MCP server for **Binance.com** (global exchange) with 156+ tools.
+
+### Location
+`/workspaces/universal-crypto-mcp/binance-mcp-server/`
+
+### Key Features
+- Full Spot Trading API (market data, orders, account)
+- Wallet API (deposits, withdrawals, transfers)
+- ETH & SOL Staking
+- Simple Earn products
+- Convert API
+- Mining API
+- Algo Trading (TWAP, VP)
+- VIP Loan
+- NFT, Pay, Copy Trading, Dual Investment
+- C2C/P2P, Fiat, Rebate
+
+### Structure
+Refactored to match `universal-crypto-mcp` patterns:
+```
+src/
+├── index.ts          # Entry point with transport selection
+├── binance.ts        # Central module registration
+├── server/           # Transport layer (base, stdio, sse)
+├── modules/          # All API modules (15 modules)
+└── utils/            # Logger, helpers
+```
+
+### Documentation Created
+- [README.md](../binance-mcp-server/README.md) - Full setup and usage guide
+- [API_COVERAGE_SUMMARY.md](../binance-mcp-server/API_COVERAGE_SUMMARY.md) - Coverage analysis
+- [BINANCE_API_GAP_ANALYSIS_PROMPTS.md](../binance-mcp-server/BINANCE_API_GAP_ANALYSIS_PROMPTS.md) - 5 agent prompts for gap analysis
+
+---
+
+## 2. Binance.US MCP Server (binance-us-mcp-server)
+
+### What Was Created
+A comprehensive MCP server for **Binance.US** (US-regulated exchange) with 71+ tools.
+
+### Location
+`/workspaces/universal-crypto-mcp/binance-us-mcp-server/`
+
+### Key Features
+- General API (ping, time, system status, exchange info)
+- Market Data (order book, trades, klines, tickers)
+- Spot Trading (orders, OCO orders, cancel/replace)
+- Wallet (deposits, withdrawals, asset config)
+- Account (balances, trade history, API permissions)
+- Staking (stake, unstake, rewards)
+- OTC Trading (quotes, orders)
+- Sub-Accounts (transfers, balances)
+- User Data Streams (listen key management)
+- Custodial Solution (institutional custody partners)
+- Credit Line (institutional credit)
+
+### Binance.US-Specific Features
+Unlike Binance.com, Binance.US:
+- No Futures/Margin trading
+- No Lending/Borrowing
+- Has Custodial Solution API (institutional)
+- Has Credit Line API (institutional)
+- US-regulated, fewer trading pairs (~150 vs 1,500+)
+
+### Documentation Created
+- [README.md](../binance-us-mcp-server/README.md) - Full documentation
+- [AGENT_PROMPTS.md](../binance-us-mcp-server/AGENT_PROMPTS.md) - 5 Claude Opus 4.5 prompts for implementing tools
+
+---
+
+## 3. Files Modified/Created Summary
+
+### New Files (binance-mcp-server)
+| File | Purpose |
+|------|---------|
+| `src/index.ts` | Entry point with --sse flag support |
+| `src/binance.ts` | Central module registration |
+| `src/server/base.ts` | Base MCP server setup |
+| `src/server/stdio.ts` | STDIO transport |
+| `src/server/sse.ts` | SSE transport |
+| `src/utils/logger.ts` | Logging utility |
+| `src/modules/*/` | 15 API modules with 156 tools |
+| `package.json` | Dependencies and scripts |
+| `tsconfig.json` | TypeScript configuration |
+
+### New Files (binance-us-mcp-server)
+| File | Purpose |
+|------|---------|
+| `src/tools/general/index.ts` | Ping, time, system status, exchange info |
+| `src/tools/market/index.ts` | Order book, trades, klines, tickers |
+| `src/tools/trade/orders.ts` | 8 order management tools |
+| `src/tools/trade/oco.ts` | 5 OCO order tools |
+| `src/tools/wallet/index.ts` | Deposits, withdrawals, addresses |
+| `src/tools/staking/index.ts` | Staking operations |
+| `src/tools/otc/index.ts` | OTC trading |
+| `src/tools/subaccount/index.ts` | Sub-account management |
+| `src/tools/userdata-stream/index.ts` | WebSocket listen keys |
+| `src/tools/custodial/index.ts` | Institutional custody |
+| `src/tools/custodial-solution/index.ts` | Custody exchange network |
+
+---
+
+## 4. Repository Comparison
+
+Analysis was performed comparing `universal-crypto-mcp` vs `sperax-crypto-mcp`:
+
+| Metric | Universal | Sperax |
+|--------|----------|--------|
+| TypeScript Files | 300+ | 104 |
+| Vendor Integrations | 15+ | 1 |
+| Dependency | Base | Depends on Universal |
+| Focus | Multi-chain EVM | Sperax Protocol |
+
+---
+
+## 5. Git History Rewrite
+
+Commits from "hippopotomonstrosesquippedaliophobi" were rewritten to "nirholas":
+
+**Commits Fixed:**
+- Add MCP Registry server.json
+- fix: server.json validation
+- fix: repository as object
+- fix: add transport type
+- fix: remove packages
+- fix: add version
+
+---
+
+## 6. How to Use
+
+### Binance.com Server
+```bash
+cd binance-mcp-server
+npm install
+npm run start        # STDIO
+npm run start:sse    # SSE
+```
+
+### Binance.US Server
+```bash
+cd binance-us-mcp-server
+npm install
+npm run build
+npm run start        # STDIO
+```
+
+### Claude Desktop Config
+```json
+{
+  "mcpServers": {
+    "binance": {
+      "command": "npx",
+      "args": ["ts-node", "binance-mcp-server/src/index.ts"],
+      "env": {
+        "BINANCE_API_KEY": "your_key",
+        "BINANCE_API_SECRET": "your_secret"
+      }
+    },
+    "binance-us": {
+      "command": "node",
+      "args": ["binance-us-mcp-server/build/index.js"],
+      "env": {
+        "BINANCE_US_API_KEY": "your_key",
+        "BINANCE_US_API_SECRET": "your_secret"
+      }
+    }
+  }
+}
+```
+
+---
+
+## 7. Next Steps / Future Work
+
+### High Priority
+1. Add Margin Trading to binance-mcp-server
+2. Add Futures Trading to binance-mcp-server
+3. Complete Simple Earn coverage (currently 30%)
+4. Complete Copy Trading (currently 20%)
+
+### Medium Priority
+5. Add Auto-Invest module
+6. Add Crypto Loans module
+7. Add Sub-Account module to binance-mcp-server
+8. WebSocket stream support
+
+### Low Priority
+9. Gift Card API
+10. Portfolio Margin
+11. Options Trading
+
+---
+
+## 8. Documentation Index
+
+| Document | Location | Purpose |
+|----------|----------|---------|
+| This Summary | `docs/SESSION_SUMMARY_2026-01-20.md` | Session overview |
+| Binance README | `binance-mcp-server/README.md` | Usage guide |
+| Binance.US README | `binance-us-mcp-server/README.md` | Usage guide |
+| API Coverage | `binance-mcp-server/API_COVERAGE_SUMMARY.md` | Gap analysis |
+| Gap Analysis Prompts | `binance-mcp-server/BINANCE_API_GAP_ANALYSIS_PROMPTS.md` | Agent prompts |
+| Agent Prompts | `binance-us-mcp-server/AGENT_PROMPTS.md` | Implementation prompts |
+| Binance.US API Docs | `binance-us-docs.md` | 13,074 lines of API reference |