@quantish/agent 0.1.6 → 0.1.7

package/README.md

@@ -1,45 +1,19 @@
-# @quantish/cli
+# @quantish/agent
 
-AI-powered CLI agent for building trading bots on Polymarket.
+AI-powered CLI agent for building trading bots and applications on Polymarket.
 
 Combines **coding tools** (file system, shell, git) with **trading tools** (Polymarket orders, positions, wallet) powered by Claude AI.
 
-## How It Works
-
-Quantish CLI connects to the **Quantish Signing Server** to execute trades on Polymarket. Here's why:
-
-### Why We Use a Signing Server
-
-Polymarket uses a **gasless relayer system** - this means:
-- ✅ **Free wallet creation** - No MATIC needed to set up
-- ✅ **Free trading** - Polymarket covers gas fees on all transactions
-- ✅ **Simplified signing** - Our server handles the complex signature formats
-
-To make this work reliably, the Quantish Signing Server:
-1. **Handles wallet creation** - Your wallet is created and managed through our server
-2. **Signs transactions** - Orders are signed using Polymarket's required format
-3. **Relays to Polymarket** - Transactions go through Polymarket's official relayer
-4. **Bypasses geo-restrictions** - Our server is hosted in a compatible region
-
-### What This Means for You
-
-- **Your funds are secure** - Only you can authorize transactions via your API key
-- **Wallets are non-custodial** - You can export your private key anytime with `export_private_key`
-- **Trading is free** - No gas fees, ever
-- **It just works** - No VPN or complex setup needed
-
-> 🔒 **Security Note**: Your private keys are stored encrypted. You can export them and migrate to a self-hosted solution in the future if needed.
-
 ## Installation
 
 ```bash
-npm install -g @quantish/cli
+npm install -g @quantish/agent
 ```
 
 Or run directly with npx:
 
 ```bash
-npx @quantish/cli
+npx @quantish/agent
 ```
 
 ## Quick Start
@@ -67,15 +41,15 @@ quantish
 Example conversations:
 
 ```
-You: Create a trading bot that monitors my positions and sells when profit > 20%
-Assistant: I'll create that for you. Let me first check your current positions...
-[Calling get_positions...]
-[Writing bot.ts...]
+You: Create a trading bot that monitors Bitcoin markets and alerts on price changes
+Assistant: I'll create that for you. Let me first search for Bitcoin markets...
+[Calling search_markets...]
+[Writing bitcoin-monitor.js...]
 
 You: What's my current balance?
-Assistant: Your Safe wallet has 0.68 USDC available for trading.
+Assistant: Your Safe wallet has 125.50 USDC available for trading.
 
-You: Place a $5 YES order on Trump winning at 55 cents
+You: Place a $10 YES order on Trump winning at 55 cents
 Assistant: Order placed! Order ID: abc123...
 ```
 
@@ -85,12 +59,6 @@ Assistant: Order placed! Order ID: abc123...
 quantish -p "check my open orders"
 ```
 
-**Piped input:**
-
-```bash
-echo "show my positions" | quantish
-```
-
 ## Commands
 
 | Command | Description |
@@ -98,6 +66,8 @@ echo "show my positions" | quantish
 | `quantish` | Start interactive chat |
 | `quantish init` | Configure API keys |
 | `quantish config` | View configuration |
+| `quantish config --server <url>` | Set custom MCP server URL |
+| `quantish config --export` | Export keys for standalone apps |
 | `quantish tools` | List available tools |
 | `quantish -p "..."` | Run one-shot prompt |
 
@@ -112,124 +82,173 @@ echo "show my positions" | quantish
 | `--version` | Show version |
 | `--help` | Show help |
 
-## Available Tools
+## Building Standalone Applications
 
-### Local Tools (Coding)
+The real power of Quantish is building standalone applications that interact with prediction markets. The agent can create trading bots, web dashboards, notification systems, and more.
 
-| Tool | Description |
-|------|-------------|
-| `read_file` | Read file contents |
-| `write_file` | Write/create files |
-| `list_dir` | List directory contents |
-| `delete_file` | Delete files |
-| `file_exists` | Check if file exists |
-| `run_command` | Execute shell commands |
-| `grep` | Search file contents |
-| `find_files` | Find files by pattern |
-| `git_status` | Get git status |
-| `git_diff` | Show git diff |
-| `git_add` | Stage files |
-| `git_commit` | Create commits |
-| `git_log` | Show commit history |
-| `git_checkout` | Switch branches |
-| `web_search` | Search the web (Exa/DuckDuckGo) |
-| `web_answer` | AI-powered Q&A (Exa) |
-| `fetch_url` | Fetch URL content |
+### MCP API Overview
 
-### MCP Tools (Trading)
+There are two MCP endpoints:
 
-| Tool | Description |
-|------|-------------|
-| `get_balances` | Check wallet balances |
-| `get_positions` | View current positions |
-| `place_order` | Place buy/sell orders |
-| `cancel_order` | Cancel open orders |
-| `get_orders` | List orders |
-| `get_orderbook` | Get market orderbook |
-| `get_price` | Get current price |
-| `transfer_usdc` | Transfer USDC |
-| `swap_tokens` | Swap tokens |
-| `claim_winnings` | Claim from resolved markets |
+| Endpoint | Purpose | Auth Required |
+|----------|---------|---------------|
+| Trading API | Wallet, orders, positions | Yes (QUANTISH_API_KEY) |
+| Discovery API | Search markets, prices | No (public key) |
 
-## Configuration
+### Trading API (Requires Your API Key)
 
-Configuration is stored in `~/.quantish/config.json`:
+```javascript
+const response = await fetch('https://quantish-sdk-production.up.railway.app/mcp/execute', {
+  method: 'POST',
+  headers: {
+    'Content-Type': 'application/json',
+    'x-api-key': process.env.QUANTISH_API_KEY
+  },
+  body: JSON.stringify({
+    jsonrpc: '2.0',
+    method: 'tools/call',
+    params: { name: 'get_balances', arguments: {} },
+    id: Date.now()
+  })
+});
 
-```json
-{
-  "anthropicApiKey": "sk-ant-...",
-  "quantishApiKey": "pk_live_...",
-  "mcpServerUrl": "https://quantish-sdk-production.up.railway.app/mcp"
-}
+const data = await response.json();
+const result = JSON.parse(data.result.content[0].text);
 ```
 
-Environment variables take precedence:
-- `ANTHROPIC_API_KEY`
-- `QUANTISH_API_KEY`
+**Trading Tools:** `get_balances`, `get_positions`, `place_order`, `cancel_order`, `get_orders`, `get_orderbook`, `get_price`, `transfer_usdc`
+
+### Discovery API (Free, No Auth)
+
+```javascript
+const response = await fetch('https://quantish.live/mcp/execute', {
+  method: 'POST',
+  headers: {
+    'Content-Type': 'application/json',
+    'X-API-Key': 'qm_ueQeqrmvZyHtR1zuVbLYkhx0fKyVAuV8'  // Public key
+  },
+  body: JSON.stringify({
+    name: 'search_markets',           // Simple format for Discovery
+    arguments: { query: 'bitcoin', limit: 5 }
+  })
+});
+
+const data = await response.json();
+const result = JSON.parse(data.result.content[0].text);
+```
 
-## Examples
+**Discovery Tools:** `search_markets`, `get_market_details`, `get_trending_markets`, `find_arbitrage`
 
-### Build a Trading Bot
+### Example: Ask the Agent to Build an App
 
 ```bash
 quantish
-> Create a Python script that monitors the Trump market and alerts me when price drops below 40 cents
+> Create a Node.js script that monitors Bitcoin markets and sends a Discord notification when prices move more than 10%
 ```
 
-### Manage Positions
+The agent will create all necessary files:
+- Main application code with MCP helper functions
+- `package.json` with dependencies
+- `.env.example` with required environment variables
+- `README.md` with setup instructions
+
+## Architecture
 
-```bash
-quantish -p "show me my positions with unrealized P&L"
+```
+quantish (CLI)
+    │
+    ├── Local Tools (filesystem, shell, git)
+    │   └── Runs directly on your machine
+    │
+    └── MCP Tools (trading + discovery)
+        ├── Trading MCP (your wallet, orders)
+        │   └── https://quantish-sdk-production.up.railway.app/mcp
+        │
+        └── Discovery MCP (public market data)
+            └── https://quantish.live/mcp
 ```
 
-### Market Making
+## Self-Hosting
 
-```bash
-quantish
-> Help me set up a basic market making strategy. I want to place both bid and ask orders around the current mid price.
-```
+You can run your own Trading MCP server for full control over your wallet keys.
 
-### Code Review
+### Configure Custom Server
 
 ```bash
-quantish
-> Read my trading bot code in bot.ts and suggest improvements
+# Set via CLI
+quantish config --server https://your-server.com/mcp
+
+# Or via environment variable
+export MCP_SERVER_URL=https://your-server.com/mcp
 ```
 
-## Development
+### What You Need
 
-```bash
-# Clone the repo
-git clone https://github.com/quantish/cli
+1. **Server**: Deploy the `quantish-server` to Railway, Render, or your own VPS
+2. **Database**: PostgreSQL for user data and encrypted keys
+3. **Polymarket Builder Credentials**: Apply at https://polymarket.com/builder
 
-# Install dependencies
-cd packages/quantish-cli
-npm install
+See [Self-Hosting Guide](https://quantish.live/docs/self-hosting.html) for full instructions.
 
-# Build
-npm run build
+## Configuration
 
-# Run locally
-npm start
+Configuration is stored in `~/.quantish/config.json`:
 
-# Development mode (watch)
-npm run dev
+```json
+{
+  "anthropicApiKey": "sk-ant-...",
+  "quantishApiKey": "qtsh_...",
+  "mcpServerUrl": "https://quantish-sdk-production.up.railway.app/mcp",
+  "model": "claude-sonnet-4-5-20250929"
+}
 ```
 
-## Architecture
+Environment variables take precedence:
+- `ANTHROPIC_API_KEY`
+- `QUANTISH_API_KEY`
+- `MCP_SERVER_URL`
 
-```
-quantish (CLI)
-    │
-    ├── Local Tools (filesystem, shell, git)
-    │   └── Runs directly on your machine
-    │
-    └── MCP Tools (trading)
-        └── Calls Quantish MCP Server
-            └── Executes on Polymarket
-```
+## Available Tools
+
+### Local Tools (Coding)
+
+| Tool | Description |
+|------|-------------|
+| `read_file` | Read file contents |
+| `write_file` | Write/create files |
+| `edit_file` | Search and replace in files |
+| `list_dir` | List directory contents |
+| `delete_file` | Delete files |
+| `setup_env` | Create/update .env files |
+| `run_command` | Execute shell commands |
+| `grep` | Search file contents |
+| `find_files` | Find files by pattern |
+| `git_status` | Get git status |
+| `git_diff` | Show git diff |
+| `git_add` | Stage files |
+| `git_commit` | Create commits |
+
+### MCP Tools (Trading)
+
+| Tool | Description |
+|------|-------------|
+| `get_balances` | Check wallet balances |
+| `get_positions` | View current positions |
+| `place_order` | Place buy/sell orders |
+| `cancel_order` | Cancel open orders |
+| `get_orders` | List orders |
+| `get_orderbook` | Get market orderbook |
+| `get_price` | Get current price |
+| `transfer_usdc` | Transfer USDC |
 
-The agent uses Claude to understand your requests and decide which tools to use. It can combine coding and trading tools in a single conversation.
+### MCP Tools (Discovery)
+
+| Tool | Description |
+|------|-------------|
+| `search_markets` | Search markets by keyword |
+| `get_market_details` | Get full market info |
+| `get_trending_markets` | Popular markets |
+| `find_arbitrage` | Find price discrepancies |
 
 ## Platform Support
 
@@ -239,23 +258,16 @@ The agent uses Claude to understand your requests and decide which tools to use.
 | Linux | ✅ Full support |
 | Windows | ⚠️ Requires WSL |
 
-**Windows users:** Install [WSL (Windows Subsystem for Linux)](https://learn.microsoft.com/en-us/windows/wsl/install) and run Quantish from within WSL. Native Windows (PowerShell/cmd.exe) is not supported.
-
-## Environment Variables
-
-| Variable | Description |
-|----------|-------------|
-| `ANTHROPIC_API_KEY` | Your Anthropic API key (required) |
-| `QUANTISH_API_KEY` | Your Quantish trading API key |
-| `EXA_API_KEY` | Optional: Exa AI search key for powerful web search |
+**Windows users:** Install [WSL](https://learn.microsoft.com/en-us/windows/wsl/install) and run Quantish from within WSL.
 
-### Web Search
-
-Web search works without API keys (using DuckDuckGo fallback), but **Exa is strongly recommended** for AI-quality search results.
+## How It Works
 
-Get your Exa API key at: https://dashboard.exa.ai
+Quantish CLI connects to the **Quantish Signing Server** to execute trades on Polymarket:
 
-Exa is the same search engine used by Cursor, Notion, Vercel, and other leading AI products.
+- **Your funds are secure** - Only you can authorize transactions via your API key
+- **Wallets are non-custodial** - Export your private key anytime with `export_private_key`
+- **Trading is free** - No gas fees (Polymarket covers them)
+- **Self-hosting available** - Run your own server for full control
 
 ## License
 

package/dist/index.js

@@ -70,8 +70,11 @@ var ConfigManager = class {
   }
   /**
    * Get the Trading MCP server URL (user's wallet/orders)
+   * Priority: MCP_SERVER_URL env var > config file > default
    */
   getMcpServerUrl() {
+    const envUrl = process.env.MCP_SERVER_URL;
+    if (envUrl) return envUrl;
     return this.conf.get("mcpServerUrl") ?? DEFAULT_MCP_URL;
   }
   /**
@@ -98,6 +101,12 @@ var ConfigManager = class {
   setMcpServerUrl(url) {
     this.conf.set("mcpServerUrl", url);
   }
+  /**
+   * Generic setter for any config key
+   */
+  set(key, value) {
+    this.conf.set(key, value);
+  }
   /**
    * Get the model to use
    */
@@ -4206,8 +4215,19 @@ program.name("quantish").description("AI coding & trading agent for Polymarket")
 program.command("init").description("Configure Quantish CLI with your API keys").action(async () => {
   await runSetup();
 });
-program.command("config").description("View or edit configuration").option("-s, --show", "Show current configuration").option("-c, --clear", "Clear all configuration").option("--path", "Show config file path").option("--export", "Export configuration as .env format").option("--show-keys", "Show full API keys (use with caution)").action(async (options) => {
+program.command("config").description("View or edit configuration").option("-s, --show", "Show current configuration").option("-c, --clear", "Clear all configuration").option("--path", "Show config file path").option("--export", "Export configuration as .env format").option("--show-keys", "Show full API keys (use with caution)").option("--server <url>", "Set custom Trading MCP server URL").action(async (options) => {
   const config = getConfigManager();
+  if (options.server) {
+    try {
+      new URL(options.server);
+    } catch {
+      error("Invalid URL format. Please provide a valid URL (e.g., https://your-server.com/mcp)");
+      return;
+    }
+    config.set("mcpServerUrl", options.server);
+    success(`Trading MCP server URL set to: ${options.server}`);
+    return;
+  }
   if (options.path) {
     console.log(config.getConfigPath());
     return;

package/package.json

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