@covalenthq/goldrush-mcp-server 0.0.2 → 0.0.3

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2025 Covalent
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+MIT License
+
+Copyright (c) 2025 Covalent
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 SOFTWARE.

package/README.md

@@ -57,6 +57,8 @@ Model Context Protocol (MCP) is a message protocol for connecting context or too
 
 - Call Covalent GoldRush API endpoints as MCP Tools
 - Read from MCP Resources that give chain info, quote currencies, chain statuses, etc.
+- **Flexible Transport Support**: Unified server supporting both STDIO and HTTP transports
+- **Command-line Interface**: Easy configuration via CLI arguments
 - Fully testable with [Vitest](https://vitest.dev/) for testing each group of tools.
 - Modular architecture where each service is implemented as a separate module, making the codebase easier to maintain and extend.
 
@@ -144,38 +146,41 @@ Add this to your `~/.codeium/windsurf/mcp_config.json` file:
 
 ### Programmatic Usage
 
-The server is designed to be started as a subprocess by an MCP client. For example, using the [MCP TypeScript SDK](https://github.com/modelcontextprotocol/typescript-sdk):
+The server supports both STDIO and HTTP transports for different integration scenarios:
+
+#### STDIO Transport (Recommended for MCP Clients)
 
 ```typescript
 import { Client } from "@modelcontextprotocol/sdk/client/index.js";
 import { StdioClientTransport } from "@modelcontextprotocol/sdk/client/stdio.js";
 
 const transport = new StdioClientTransport({
-  command: "npx",
-  args: ["-y", "@covalenthq/goldrush-mcp-server@latest"],
-  env: {"GOLDRUSH_API_KEY"="your_api_key_here"}
+    command: "npx",
+    args: ["-y", "@covalenthq/goldrush-mcp-server@latest"],
+    env: { GOLDRUSH_API_KEY: "your_api_key_here" },
 });
 
 const client = new Client(
-  {
-    name: "example-client",
-    version: "1.0.0"
-  },
-  {
-    capabilities: {
-      tools: {}
+    {
+        name: "example-client",
+        version: "1.0.0",
+    },
+    {
+        capabilities: {
+            tools: {},
+        },
     }
-  }
 );
 
 await client.connect(transport);
 
-// List tools
-const resources = await client.listTools();
+// List tools and call them
 const tools = await client.listTools();
-console.log("Available tools:", tools.tools.map(tool => tool.name).join(", "));
+console.log(
+    "Available tools:",
+    tools.tools.map((tool) => tool.name).join(", ")
+);
 
-// Now you can call tools
 const result = await client.callTool({
     name: "token_balances",
     arguments: {
@@ -186,7 +191,42 @@ const result = await client.callTool({
     },
 });
 console.log("Token balances:", result.content);
-...
+```
+
+#### HTTP Transport (For Web Integrations)
+
+```bash
+# Start the HTTP server
+node dist/index.js --transport http --port 3000
+```
+
+Then make HTTP requests:
+
+```javascript
+const response = await fetch("http://localhost:3000/mcp", {
+    method: "POST",
+    headers: {
+        "Content-Type": "application/json",
+        Authorization: "Bearer YOUR_GOLDRUSH_API_KEY",
+    },
+    body: JSON.stringify({
+        jsonrpc: "2.0",
+        id: 1,
+        method: "tools/call",
+        params: {
+            name: "token_balances",
+            arguments: {
+                chainName: "eth-mainnet",
+                address: "0xfC43f5F9dd45258b3AFf31Bdbe6561D97e8B71de",
+                quoteCurrency: "USD",
+                nft: false,
+            },
+        },
+    }),
+});
+
+const result = await response.json();
+console.log("Token balances:", result);
 ```
 
 ### Example LLM Flow
@@ -205,107 +245,81 @@ Tools are a powerful primitive in the Model Context Protocol (MCP) that enable s
 Tools are designed to be model-controlled, meaning that tools are exposed from servers to clients with the intention of the AI model being able to automatically invoke them (with a human in the loop to grant approval).
 
 1. `bitcoin_hd_wallet_balances`
-
     - Fetch balances for each active child address derived from a Bitcoin HD wallet. This tool provides detailed balance data for Bitcoin wallets identified by an xpub key. Required: walletAddress - The xpub key of the HD wallet. Optional: quoteCurrency - The currency for price conversion (USD, EUR, etc). Returns complete balance details including total balance, available balance, and transaction history summary.
 
 2. `bitcoin_non_hd_wallet_balances`
-
     - Fetch Bitcoin balance for a non-HD address. Response includes spot prices and other metadata. This tool provides detailed balance data for regular Bitcoin addresses. Required: walletAddress - The Bitcoin address to query. Optional: quoteCurrency - The currency for price conversion (USD, EUR, etc). Returns complete balance details including total balance, available balance, and transaction count.
 
 3. `bitcoin_transactions`
-
     - Fetch transactions for a specific Bitcoin address with full transaction details. Required: address - The Bitcoin address to query. Optional: pageSize - Number of results per page (default 100), pageNumber - Page number (default 0). Returns a paginated list of transactions with timestamps, amounts, inputs, outputs, and fees.
 
 4. `block`
-
     - Commonly used to fetch and render a single block for a block explorer. Requires chainName (blockchain network) and blockHeight (block number). Returns comprehensive block data including timestamp, transaction count, size, miner information, and other blockchain-specific details.
 
 5. `block_heights`
-
     - Commonly used to get all the block heights within a particular date range. Requires chainName (blockchain network), startDate (YYYY-MM-DD format), and endDate (YYYY-MM-DD or 'latest'). Optional pagination parameters include pageSize (default 10) and pageNumber (default 0). Returns block heights, timestamps, and related data for blocks within the specified date range, useful for historical analysis and time-based blockchain queries.
 
 6. `erc20_token_transfers`
-
     - Commonly used to render the transfer-in and transfer-out of a token along with historical prices from an address. Required: chainName (blockchain network), walletAddress (wallet address). Optional: quoteCurrency for value conversion, contractAddress to filter by specific token, startingBlock/endingBlock to set range, pageSize (default 10) and pageNumber (default 0). Returns token transfer events with timestamps, values, and transaction details.
 
 7. `gas_prices`
-
     - Get real-time gas estimates for different transaction speeds on a specific network, enabling users to optimize transaction costs and confirmation times. Requires chainName (blockchain network) and eventType (erc20, nativetokens, or uniswapv3). Optional parameter quoteCurrency allows conversion to different currencies (USD, EUR, etc). Returns estimated gas prices for low, medium, and high priority transactions for the specified event type.
 
 8. `historical_portfolio_value`
-
     - Commonly used to render a daily portfolio balance for an address broken down by the token. Required: chainName (blockchain network), walletAddress (wallet address). Optional: quoteCurrency for value conversion, days (timeframe to analyze, default 7). Returns portfolio value time series data showing value changes over the specified timeframe.
 
 9. `historical_token_balances`
-
     - Commonly used to fetch the historical native and fungible (ERC20) tokens held by an address at a given block height or date. Required: chainName (blockchain network), address (wallet address). Optional: quoteCurrency for value conversion, blockHeight or date to specify point in time, nft (include NFTs, default false), noNftFetch, noSpam, and noNftAssetMetadata (all default true). Returns token balances as they existed at the specified historical point.
 
 10. `historical_token_prices`
-
     - Commonly used to get historic prices of a token between date ranges. Supports native tokens. Required: chainName (blockchain network), quoteCurrency (price currency), contractAddress (token contract), from (start date YYYY-MM-DD), to (end date YYYY-MM-DD). Optional: pricesAtAsc (set to true for chronological ascending order, default is false for descending order). Returns historical token prices for the specified time range.
 
 11. `log_events_by_address`
-
     - Commonly used to get all the event logs emitted from a particular contract address. Useful for building dashboards that examine on-chain interactions. Requires chainName (blockchain network) and contractAddress (the address emitting events). Optional parameters include block range (startingBlock, endingBlock) and pagination settings (pageSize default 10, pageNumber default 0). Returns decoded event logs for the specified contract, useful for monitoring specific smart contract activity and analyzing on-chain events.
 
 12. `log_events_by_topic`
-
     - Commonly used to get all event logs of the same topic hash across all contracts within a particular chain. Useful for cross-sectional analysis of event logs that are emitted on-chain. Requires chainName (blockchain network) and topicHash (the event signature hash). Optional parameters include block range (startingBlock, endingBlock), secondaryTopics for filtering by additional parameters, and pagination settings (pageSize default 10, pageNumber default 0). Returns decoded event logs matching the specified topic hash, ideal for tracking specific event types across multiple contracts on a blockchain.
 
 13. `multichain_address_activity`
-
     - Gets a summary of wallet activity across all supported blockchains. Requires walletAddress. Optional parameter testnets (default false) determines whether to include testnet activity. Returns a comprehensive summary of chain activity including transaction counts, first/last activity timestamps, and activity status across all networks.
 
 14. `multichain_balances`
-
     - Gets token balances for a wallet address across multiple blockchains. Requires walletAddress. Optional parameters include chains array to specify networks, quoteCurrency for value conversion, limit (default 10), pagination (before), and cutoffTimestamp to filter by time. Use this to get a comprehensive view of token holdings across different blockchains.
 
 15. `multichain_transactions`
-
     - Gets transactions for multiple wallet addresses across multiple blockchains. Requires addresses array. Optional parameters include chains array, pagination (before/after), limit (default 10), quoteCurrency for value conversion, and options to include logs (withLogs, withDecodedLogs). Use this to analyze transaction history across different networks simultaneously.
 
 16. `native_token_balance`
-
     - Get the native token balance (ETH, BNB, MATIC, etc.) for a specified wallet address on a blockchain. Required: chainName (blockchain network) and walletAddress. Optional: quoteCurrency for value conversion and blockHeight for historical queries. Returns detailed balance information including formatted amounts and USD values.
 
 17. `nft_check_ownership`
-
     - Commonly used to verify ownership of NFTs (including ERC-721 and ERC-1155) within a collection. Required: chainName (blockchain network), walletAddress (wallet address), collectionContract (NFT collection). Optional: traitsFilter (filter by trait types), valuesFilter (filter by trait values). Returns ownership status and matching NFTs if owned.
 
 18. `nft_for_address`
-
     - Commonly used to get all NFTs owned by a specific wallet address on a blockchain. Useful for NFT portfolio viewers. Required: chainName (blockchain network), walletAddress (wallet address). Optional: noSpam (exclude spam NFTs, default true), noNftAssetMetadata (exclude detailed metadata, default false), withUncached (include uncached items, default false). Returns a comprehensive list of all NFTs owned by the specified wallet.
 
 19. `pool_spot_prices`
-
     - Get the spot token pair prices for a specified pool contract address. Supports pools on Uniswap V2, V3 and their forks. Required: chainName (blockchain network), contractAddress (pool contract address). Optional: quoteCurrency (price currency) for value conversion. Returns spot token pair prices with pool details and token metadata.
 
 20. `token_approvals`
-
     - Commonly used to get a list of approvals across all token contracts categorized by spenders for a wallet's assets. Required: chainName (blockchain network, e.g. eth-mainnet or 1), walletAddress (wallet address, supports ENS, RNS, Lens Handle, or Unstoppable Domain). Returns a list of ERC20 token approvals and their associated security risk levels.
 
 21. `token_balances`
-
     - Commonly used to fetch the native and fungible (ERC20) tokens held by an address. Required: chainName (blockchain network), address (wallet address). Optional: quoteCurrency for value conversion, nft (include NFTs, default false), noNftFetch, noSpam, and noNftAssetMetadata (all default true) to control data returned. Returns detailed token balance information including spot prices and metadata.
 
 22. `token_holders`
-
     - Used to get a paginated list of current or historical token holders for a specified ERC20 or ERC721 token. Required: chainName (blockchain network), tokenAddress (token contract address). Optional: blockHeight or date for historical data, pageSize and pageNumber for pagination. Returns list of addresses holding the token with balance amounts and ownership percentages.
 
 23. `transaction`
-
     - Commonly used to fetch and render a single transaction including its decoded log events. Required: chainName (blockchain network), txHash (transaction hash). Optional: quoteCurrency (currency to convert to, USD by default), noLogs (exclude event logs, true by default), withInternal (include internal transactions, false by default), withState (include state changes, false by default), withInputData (include input data, false by default). Tracing features (withInternal, withState, withInputData) supported on the following chains: eth-mainnet. Returns comprehensive details about the specified transaction.
 
 24. `transaction_summary`
-
     - Commonly used to fetch the earliest and latest transactions, and the transaction count for a wallet. Required: chainName (blockchain network), walletAddress (wallet address). Optional: quoteCurrency, withGas (include gas usage statistics). Returns summary of transaction activity for the specified wallet.
 
 25. `transactions_for_address`
-
     - Commonly used to fetch and render the most recent transactions involving an address. Required: chainName (blockchain network), walletAddress (wallet address), page (page number). Optional: quoteCurrency, noLogs, blockSignedAtAsc (chronological order). Returns transactions for the specified page of results.
 
 26. `transactions_for_block`
-
     - Commonly used to fetch all transactions including their decoded log events in a block and further flag interesting wallets or transactions. Required: chainName (blockchain network), blockHeight (block number or latest). Optional: quoteCurrency, noLogs (exclude event logs). Returns all transactions from the specified block.
 
 ---
@@ -323,7 +337,6 @@ Resources are designed to be application-controlled, meaning that the client app
 Resources exposed by the GoldRush MCP server are split into static and dynamic types:
 
 - Static resources (`src/resources/staticResources.ts`):
-
     - `config://supported-chains`
     - `config://quote-currencies`
 
@@ -359,12 +372,36 @@ npm run build
 
 ### Running the MCP Server
 
+The server supports multiple transport options:
+
 ```bash
-# Start the server (runs dist/index.js)
+# Start with default STDIO transport (recommended for MCP clients)
 npm run start
+
+# Or explicitly specify STDIO transport
+npm run start:stdio
+
+# Start with HTTP transport on port 3000
+npm run start:http
+
+# Custom configuration with CLI arguments
+node dist/index.js --transport http --port 8080
+node dist/index.js --transport stdio --api-key YOUR_KEY_HERE
 ```
 
-This spawns the MCP server on stdin/stdout. Typically, an MCP client will connect to the server.
+#### Transport Options
+
+- **STDIO (default)**: Direct MCP protocol communication via stdin/stdout - ideal for MCP clients like Claude Desktop
+- **HTTP**: RESTful HTTP server with `/mcp` endpoint - useful for web integrations
+
+#### Command Line Arguments
+
+- `--transport`, `-t`: Choose transport type (`stdio` or `http`)
+- `--port`, `-p`: Set HTTP port (default: 3000)
+- `--api-key`, `-k`: Provide API key directly
+- `--help`, `-h`: Show usage information
+
+STDIO transport spawns the MCP server on stdin/stdout where MCP clients can connect directly. HTTP transport starts a server that accepts POST requests to `/mcp` with Bearer token authentication.
 
 ### Example Client
 
@@ -404,7 +441,9 @@ set GOLDRUSH_API_KEY=YOUR_KEY_HERE
 ```
 goldrush-mcp-server
 ├── src
-│   ├── index.ts                 # Main MCP server entry point
+│   ├── index.ts                 # Main entry point with CLI parsing
+│   ├── server.ts                # Unified server with STDIO and HTTP transports
+│   ├── server-stdio.ts          # Legacy STDIO-only server (backup)
 │   ├── services/                # Modular service implementations
 │   │   ├── AllChainsService.ts  # Cross-chain service tools
 │   │   ├── BalanceService.ts    # Balance-related tools

package/dist/index.d.ts

@@ -1,4 +1,3 @@
 #!/usr/bin/env node
-import { createGoldRushClient, createServer, startServer } from "./server.js";
-export { createGoldRushClient, createServer, startServer };
+export {};
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,oBAAoB,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAM9E,OAAO,EAAE,oBAAoB,EAAE,YAAY,EAAE,WAAW,EAAE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -1,5 +1,4 @@
 #!/usr/bin/env node
-import { createGoldRushClient, createServer, startServer } from "./server.js";
-startServer().catch(console.error);
-export { createGoldRushClient, createServer, startServer };
+import { parseArgsAndStart } from "./server.js";
+parseArgsAndStart();
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,oBAAoB,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAG9E,WAAW,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAGnC,OAAO,EAAE,oBAAoB,EAAE,YAAY,EAAE,WAAW,EAAE,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAGhD,iBAAiB,EAAE,CAAC"}

package/dist/resources/dynamicResources.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dynamicResources.d.ts","sourceRoot":"","sources":["../../src/resources/dynamicResources.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAiBzE,wBAAgB,+BAA+B,CAC3C,MAAM,EAAE,SAAS,EACjB,cAAc,EAAE,cAAc,QAkFjC"}
+{"version":3,"file":"dynamicResources.d.ts","sourceRoot":"","sources":["../../src/resources/dynamicResources.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAkBzE,wBAAgB,+BAA+B,CAC3C,MAAM,EAAE,SAAS,EACjB,cAAc,EAAE,cAAc,QA4FjC"}

package/dist/resources/dynamicResources.js

@@ -1,19 +1,26 @@
 import { stringifyWithBigInt } from "../utils/helpers.js";
 import { ResourceTemplate } from "@modelcontextprotocol/sdk/server/mcp.js";
 export function addRealTimeChainStatusResources(server, goldRushClient) {
-    server.resource("all-chains-status", "status://all-chains", async (uri) => {
+    server.registerResource("all-chains-status", "status://all-chains", {
+        title: "All Chains Status",
+        description: "All chains status",
+        mimeType: "application/json",
+    }, async () => {
         const response = await goldRushClient.BaseService.getAllChainStatus();
         return {
             contents: [
                 {
-                    uri: uri.href,
+                    uri: "status://all-chains",
                     text: stringifyWithBigInt(response.data),
                 },
             ],
         };
     });
-    const chainStatusTemplate = new ResourceTemplate("status://chain/{chainName}", { list: undefined });
-    server.resource("chain-status", chainStatusTemplate, async (uri, { chainName }) => {
+    server.resource("chain-status", new ResourceTemplate("status://chain/{chainName}", { list: undefined }), {
+        title: "Chain Status",
+        description: "Chain status",
+        mimeType: "application/json",
+    }, async (uri, { chainName }) => {
         const response = await goldRushClient.BaseService.getAllChainStatus();
         const data = response.data;
         if (!data || !data.items) {

package/dist/resources/dynamicResources.js.map

@@ -1 +1 @@
-{"version":3,"file":"dynamicResources.js","sourceRoot":"","sources":["../../src/resources/dynamicResources.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAG1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,yCAAyC,CAAC;AAgB3E,MAAM,UAAU,+BAA+B,CAC3C,MAAiB,EACjB,cAA8B;IAG9B,MAAM,CAAC,QAAQ,CAAC,mBAAmB,EAAE,qBAAqB,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;QAEtE,MAAM,QAAQ,GAAG,MAAM,cAAc,CAAC,WAAW,CAAC,iBAAiB,EAAE,CAAC;QACtE,OAAO;YACH,QAAQ,EAAE;gBACN;oBACI,GAAG,EAAE,GAAG,CAAC,IAAI;oBACb,IAAI,EAAE,mBAAmB,CAAC,QAAQ,CAAC,IAAI,CAAC;iBAC3C;aACJ;SACJ,CAAC;IACN,CAAC,CAAC,CAAC;IAGH,MAAM,mBAAmB,GAAG,IAAI,gBAAgB,CAC5C,4BAA4B,EAC5B,EAAE,IAAI,EAAE,SAAS,EAAE,CACtB,CAAC;IACF,MAAM,CAAC,QAAQ,CACX,cAAc,EACd,mBAAmB,EACnB,KAAK,EAAE,GAAG,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE;QAEzB,MAAM,QAAQ,GACV,MAAM,cAAc,CAAC,WAAW,CAAC,iBAAiB,EAAE,CAAC;QACzD,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC;QAC3B,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;YACvB,OAAO;gBACH,QAAQ,EAAE;oBACN;wBACI,GAAG,EAAE,GAAG,CAAC,IAAI;wBACb,IAAI,EAAE,IAAI,CAAC,SAAS,CAChB,EAAE,KAAK,EAAE,8BAA8B,EAAE,EACzC,IAAI,EACJ,CAAC,CACJ;qBACJ;iBACJ;aACJ,CAAC;QACN,CAAC;QACD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;QAE/B,MAAM,WAAW,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAM,EAAE,EAAE;YAItC,IAAI,CAAC,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;gBACvB,OAAO,IAAI,CAAC;YAChB,CAAC;YAED,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC;gBAC5B,OAAO,CAAC,CAAC,QAAQ,KAAK,MAAM,CAAC,SAAS,CAAC,CAAC;YAC5C,CAAC;YACD,OAAO,KAAK,CAAC;QACjB,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,WAAW,EAAE,CAAC;YACf,OAAO;gBACH,QAAQ,EAAE;oBACN;wBACI,GAAG,EAAE,GAAG,CAAC,IAAI;wBACb,IAAI,EAAE,IAAI,CAAC,SAAS,CAChB,EAAE,KAAK,EAAE,wBAAwB,SAAS,EAAE,EAAE,EAC9C,IAAI,EACJ,CAAC,CACJ;qBACJ;iBACJ;aACJ,CAAC;QACN,CAAC;QACD,OAAO;YACH,QAAQ,EAAE;gBACN;oBACI,GAAG,EAAE,GAAG,CAAC,IAAI;oBACb,IAAI,EAAE,mBAAmB,CAAC,WAAW,CAAC;iBACzC;aACJ;SACJ,CAAC;IACN,CAAC,CACJ,CAAC;AACN,CAAC"}
+{"version":3,"file":"dynamicResources.js","sourceRoot":"","sources":["../../src/resources/dynamicResources.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAG1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,yCAAyC,CAAC;AAiB3E,MAAM,UAAU,+BAA+B,CAC3C,MAAiB,EACjB,cAA8B;IAG9B,MAAM,CAAC,gBAAgB,CACnB,mBAAmB,EACnB,qBAAqB,EACrB;QACI,KAAK,EAAE,mBAAmB;QAC1B,WAAW,EAAE,mBAAmB;QAChC,QAAQ,EAAE,kBAAkB;KAC/B,EACD,KAAK,IAAiC,EAAE;QAEpC,MAAM,QAAQ,GACV,MAAM,cAAc,CAAC,WAAW,CAAC,iBAAiB,EAAE,CAAC;QACzD,OAAO;YACH,QAAQ,EAAE;gBACN;oBACI,GAAG,EAAE,qBAAqB;oBAC1B,IAAI,EAAE,mBAAmB,CAAC,QAAQ,CAAC,IAAI,CAAC;iBAC3C;aACJ;SACJ,CAAC;IACN,CAAC,CACJ,CAAC;IAEF,MAAM,CAAC,QAAQ,CACX,cAAc,EACd,IAAI,gBAAgB,CAAC,4BAA4B,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,EACvE;QACI,KAAK,EAAE,cAAc;QACrB,WAAW,EAAE,cAAc;QAC3B,QAAQ,EAAE,kBAAkB;KAC/B,EACD,KAAK,EAAE,GAAG,EAAE,EAAE,SAAS,EAAE,EAA+B,EAAE;QAEtD,MAAM,QAAQ,GACV,MAAM,cAAc,CAAC,WAAW,CAAC,iBAAiB,EAAE,CAAC;QACzD,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC;QAC3B,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;YACvB,OAAO;gBACH,QAAQ,EAAE;oBACN;wBACI,GAAG,EAAE,GAAG,CAAC,IAAI;wBACb,IAAI,EAAE,IAAI,CAAC,SAAS,CAChB,EAAE,KAAK,EAAE,8BAA8B,EAAE,EACzC,IAAI,EACJ,CAAC,CACJ;qBACJ;iBACJ;aACJ,CAAC;QACN,CAAC;QACD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;QAE/B,MAAM,WAAW,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAM,EAAE,EAAE;YAItC,IAAI,CAAC,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;gBACvB,OAAO,IAAI,CAAC;YAChB,CAAC;YAED,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC;gBAC5B,OAAO,CAAC,CAAC,QAAQ,KAAK,MAAM,CAAC,SAAS,CAAC,CAAC;YAC5C,CAAC;YACD,OAAO,KAAK,CAAC;QACjB,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,WAAW,EAAE,CAAC;YACf,OAAO;gBACH,QAAQ,EAAE;oBACN;wBACI,GAAG,EAAE,GAAG,CAAC,IAAI;wBACb,IAAI,EAAE,IAAI,CAAC,SAAS,CAChB,EAAE,KAAK,EAAE,wBAAwB,SAAS,EAAE,EAAE,EAC9C,IAAI,EACJ,CAAC,CACJ;qBACJ;iBACJ;aACJ,CAAC;QACN,CAAC;QACD,OAAO;YACH,QAAQ,EAAE;gBACN;oBACI,GAAG,EAAE,GAAG,CAAC,IAAI;oBACb,IAAI,EAAE,mBAAmB,CAAC,WAAW,CAAC;iBACzC;aACJ;SACJ,CAAC;IACN,CAAC,CACJ,CAAC;AACN,CAAC"}

package/dist/resources/staticResources.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"staticResources.d.ts","sourceRoot":"","sources":["../../src/resources/staticResources.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAWzE,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,QAoCnD"}
+{"version":3,"file":"staticResources.d.ts","sourceRoot":"","sources":["../../src/resources/staticResources.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAYzE,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,QA8CnD"}

package/dist/resources/staticResources.js

@@ -1,18 +1,26 @@
 import { validQuoteValues } from "../utils/constants.js";
 import { ChainName } from "@covalenthq/client-sdk";
 export function addStaticResources(server) {
-    server.resource("supported-chains", "config://supported-chains", async (uri) => ({
+    server.resource("supported-chains", "config://supported-chains", {
+        title: "Supported Chains",
+        description: "List of supported chain names",
+        mimeType: "application/json",
+    }, async () => ({
         contents: [
             {
-                uri: uri.href,
+                uri: "config://supported-chains",
                 text: JSON.stringify(Object.values(ChainName), null, 2),
             },
         ],
     }));
-    server.resource("quote-currencies", "config://quote-currencies", async (uri) => ({
+    server.registerResource("quote-currencies", "config://quote-currencies", {
+        title: "Quote Currencies",
+        description: "List of supported quote currencies",
+        mimeType: "application/json",
+    }, async () => ({
         contents: [
             {
-                uri: uri.href,
+                uri: "config://quote-currencies",
                 text: JSON.stringify(Object.values(validQuoteValues), null, 2),
             },
         ],

package/dist/resources/staticResources.js.map

@@ -1 +1 @@
-{"version":3,"file":"staticResources.js","sourceRoot":"","sources":["../../src/resources/staticResources.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAYnD,MAAM,UAAU,kBAAkB,CAAC,MAAiB;IAIhD,MAAM,CAAC,QAAQ,CACX,kBAAkB,EAClB,2BAA2B,EAC3B,KAAK,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC;QACZ,QAAQ,EAAE;YACN;gBACI,GAAG,EAAE,GAAG,CAAC,IAAI;gBACb,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;aAC1D;SACJ;KACJ,CAAC,CACL,CAAC;IAKF,MAAM,CAAC,QAAQ,CACX,kBAAkB,EAClB,2BAA2B,EAC3B,KAAK,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC;QACZ,QAAQ,EAAE;YACN;gBACI,GAAG,EAAE,GAAG,CAAC,IAAI;gBACb,IAAI,EAAE,IAAI,CAAC,SAAS,CAChB,MAAM,CAAC,MAAM,CAAC,gBAAgB,CAAC,EAC/B,IAAI,EACJ,CAAC,CACJ;aACJ;SACJ;KACJ,CAAC,CACL,CAAC;AACN,CAAC"}
+{"version":3,"file":"staticResources.js","sourceRoot":"","sources":["../../src/resources/staticResources.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAanD,MAAM,UAAU,kBAAkB,CAAC,MAAiB;IAIhD,MAAM,CAAC,QAAQ,CACX,kBAAkB,EAClB,2BAA2B,EAC3B;QACI,KAAK,EAAE,kBAAkB;QACzB,WAAW,EAAE,+BAA+B;QAC5C,QAAQ,EAAE,kBAAkB;KAC/B,EACD,KAAK,IAAiC,EAAE,CAAC,CAAC;QACtC,QAAQ,EAAE;YACN;gBACI,GAAG,EAAE,2BAA2B;gBAChC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;aAC1D;SACJ;KACJ,CAAC,CACL,CAAC;IAKF,MAAM,CAAC,gBAAgB,CACnB,kBAAkB,EAClB,2BAA2B,EAC3B;QACI,KAAK,EAAE,kBAAkB;QACzB,WAAW,EAAE,oCAAoC;QACjD,QAAQ,EAAE,kBAAkB;KAC/B,EACD,KAAK,IAAiC,EAAE,CAAC,CAAC;QACtC,QAAQ,EAAE;YACN;gBACI,GAAG,EAAE,2BAA2B;gBAChC,IAAI,EAAE,IAAI,CAAC,SAAS,CAChB,MAAM,CAAC,MAAM,CAAC,gBAAgB,CAAC,EAC/B,IAAI,EACJ,CAAC,CACJ;aACJ;SACJ;KACJ,CAAC,CACL,CAAC;AACN,CAAC"}

package/dist/server.d.ts

@@ -1,6 +1,14 @@
 import { GoldRushClient } from "@covalenthq/client-sdk";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-export declare function createGoldRushClient(): GoldRushClient;
-export declare function createServer(): McpServer;
-export declare function startServer(): Promise<void>;
+type TransportType = "stdio" | "http";
+export declare function createGoldRushClient(apiKey?: string): GoldRushClient;
+export declare function createServer(apiKey?: string): McpServer;
+export declare function startStdioServer(apiKey?: string): Promise<void>;
+export declare function startHttpServer(port?: number): void;
+export declare function startServer(transportType?: TransportType, options?: {
+    port?: number;
+    apiKey?: string;
+}): Promise<void>;
+export declare function parseArgsAndStart(): void;
+export {};
 //# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAapE,wBAAgB,oBAAoB,mBAOnC;AAKD,wBAAgB,YAAY,cAqB3B;AAKD,wBAAsB,WAAW,kBAShC"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAapE,KAAK,aAAa,GAAG,OAAO,GAAG,MAAM,CAAC;AAQtC,wBAAgB,oBAAoB,CAAC,MAAM,CAAC,EAAE,MAAM,kBAQnD;AAKD,wBAAgB,YAAY,CAAC,MAAM,CAAC,EAAE,MAAM,aAwB3C;AAKD,wBAAsB,gBAAgB,CAAC,MAAM,CAAC,EAAE,MAAM,iBASrD;AAKD,wBAAgB,eAAe,CAAC,IAAI,GAAE,MAAqB,QAoH1D;AAKD,wBAAsB,WAAW,CAC7B,aAAa,GAAE,aAAuB,EACtC,OAAO,GAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAO,iBAcnD;AAKD,wBAAgB,iBAAiB,SA8FhC"}