@quantish/agent 0.1.8 → 0.1.10

package/dist/index.js

@@ -2751,7 +2751,28 @@ const data = await response.json();
 const result = JSON.parse(data.result.content[0].text);
 \`\`\`
 
+### \u26A0\uFE0F CRITICAL: Tool-to-Server Mapping (MEMORIZE THIS)
+
+| Tool Name | Server | Auth Required | Helper Function |
+|-----------|--------|---------------|-----------------|
+| \`get_balances\` | TRADING | Yes (QUANTISH_API_KEY) | callTradingTool() |
+| \`get_positions\` | TRADING | Yes | callTradingTool() |
+| \`place_order\` | TRADING | Yes | callTradingTool() |
+| \`cancel_order\` | TRADING | Yes | callTradingTool() |
+| \`get_orders\` | TRADING | Yes | callTradingTool() |
+| \`get_orderbook\` | TRADING | Yes | callTradingTool() |
+| \`get_price\` | TRADING | Yes | callTradingTool() |
+| \`get_deposit_addresses\` | TRADING | Yes | callTradingTool() |
+| \`transfer_usdc\` | TRADING | Yes | callTradingTool() |
+| \`search_markets\` | DISCOVERY | No (public key) | callDiscoveryTool() |
+| \`get_market_details\` | DISCOVERY | No | callDiscoveryTool() |
+| \`get_trending_markets\` | DISCOVERY | No | callDiscoveryTool() |
+| \`find_arbitrage\` | DISCOVERY | No | callDiscoveryTool() |
+
 ### Key Trading Tools (require QUANTISH_API_KEY)
+URL: https://quantish-sdk-production.up.railway.app/mcp/execute
+Format: JSON-RPC 2.0 ({ jsonrpc, method, params, id })
+
 - \`get_balances\`: Returns { usdc, nativeUsdc, matic } for EOA and Safe wallets
 - \`get_positions\`: Returns array of current share holdings with market info
 - \`place_order\`: Place order. Args: { conditionId, tokenId, side: "BUY"|"SELL", price: 0.01-0.99, size: number }
@@ -2763,6 +2784,8 @@ const result = JSON.parse(data.result.content[0].text);
 - \`transfer_usdc\`: Send USDC. Args: { toAddress, amount }
 
 ### Key Discovery Tools (free, no auth required)
+URL: https://quantish.live/mcp/execute
+Format: Simple ({ name, arguments }) - NOT JSON-RPC!
 Discovery uses a SIMPLER request format (not full JSON-RPC):
 \`\`\`javascript
 // Discovery API - uses simple { name, arguments } format
@@ -2800,6 +2823,19 @@ Example flow:
 3. Extract tokenId for YES/NO outcome you want
 4. place_order({ conditionId, tokenId, side: "BUY", price: 0.55, size: 100 })
 
+### \u26A0\uFE0F CRITICAL: Market Search Behavior
+When searching for markets:
+1. **ALWAYS look at the actual results** - Don't say "I don't see any" without checking
+2. **Be flexible with timeframes** - If user asks for "15 minute" market, use any similar short-term market (5min, 10min, 30min)
+3. **Show what IS available** - If exact match not found, show the user what markets ARE available
+4. **Extract and use the data** - The search returns clobTokenIds, conditionId, etc. - USE THEM
+5. **Parse the results properly** - Results are in data.result.content[0].text as JSON string
+
+The search results contain EVERYTHING needed:
+- \`markets[].markets[].clobTokenIds\` - Parse this JSON string to get token IDs
+- \`markets[].markets[].conditionId\` - The condition ID for orders
+- \`markets[].title\` - Market title with timeframe info
+
 ### Bot Code Template (Node.js)
 \`\`\`javascript
 #!/usr/bin/env node
@@ -2861,14 +2897,24 @@ When generating ANY code that uses Quantish/MCP (bots, apps, scripts, APIs, etc.
 
 ### MANDATORY Requirements
 
-1. **ALWAYS include the callTool() helper function** - Copy it EXACTLY from the template above
-2. **ALWAYS use callTool() for ALL MCP operations** - Never use direct API calls to Polymarket
-3. **NEVER hardcode prices, market data, or API responses** - Always fetch live data via callTool()
+1. **ALWAYS include BOTH callTradingTool() AND callDiscoveryTool() helper functions** - Copy them EXACTLY from the template
+2. **USE THE CORRECT HELPER FOR EACH TOOL** - Check the tool-to-server mapping table above!
+   - Trading tools (get_price, get_orderbook, place_order, etc.) \u2192 callTradingTool()
+   - Discovery tools (search_markets, get_market_details, etc.) \u2192 callDiscoveryTool()
+3. **NEVER hardcode prices, market data, or API responses** - Always fetch live data
 4. **NEVER comment out MCP calls** - All API calls must be real, working, executable code
 5. **ALWAYS create .env.example** - Document all required environment variables
-6. **ALWAYS validate QUANTISH_API_KEY exists** - Fail fast with clear error if missing
+6. **ALWAYS validate QUANTISH_API_KEY exists** when using Trading tools - Fail fast with clear error if missing
 7. **ALWAYS use dotenv** - \`require('dotenv').config()\` at the top of every file
 
+### \u26D4 NEVER DO WORKAROUNDS
+
+- **NEVER try to "work around" missing tools** - If a tool requires auth, use auth
+- **NEVER substitute one tool for another** - get_market_details is NOT a replacement for get_price
+- **NEVER use the Discovery API for tools that require Trading API** - They are separate servers
+- **NEVER mock or simulate API responses** - Always make real API calls
+- **If a feature requires QUANTISH_API_KEY, tell the user they need one** - Don't try to avoid it
+
 ### File Structure for ANY Application
 
 When creating an application, ALWAYS create these files:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@quantish/agent",
-  "version": "0.1.8",
+  "version": "0.1.10",
   "description": "AI-powered agent for building trading bots on Polymarket",
   "type": "module",
   "bin": {