@sureshotlabs/hunch-agent-tools 0.1.1

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@sureshotlabs/hunch-agent-tools",
+  "version": "0.1.1",
+  "description": "Public read-only MCP server and CLI for Hunch prediction-market research.",
+  "license": "UNLICENSED",
+  "type": "module",
+  "bin": {
+    "hunch-agent-tools": "./build/hunch-mcp.js",
+    "hunch-mcp": "./build/hunch-mcp.js",
+    "hunch-agent": "./build/hunch-agent.js"
+  },
+  "files": [
+    "build",
+    "skills",
+    "README.md"
+  ],
+  "keywords": [
+    "hunch",
+    "prediction-markets",
+    "mcp",
+    "mcp-server",
+    "model-context-protocol",
+    "codex",
+    "trading-research"
+  ],
+  "engines": {
+    "node": ">=20.19.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+ssh://git@github.com/x0rb0t/hunch-agent-tools.git"
+  },
+  "homepage": "https://github.com/x0rb0t/hunch-agent-tools#readme",
+  "bugs": {
+    "url": "https://github.com/x0rb0t/hunch-agent-tools/issues"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  }
+}

package/skills/hunch-trading/SKILL.md

@@ -0,0 +1,67 @@
+---
+name: hunch-trading
+description: Use when an agent needs to search public Hunch markets, inspect market/event/cluster data, read public wallet intelligence, use Hunch MCP or CLI tools, or compare public prediction-market context. This skill is read-only and must not claim to log in, read private accounts, create intents, execute, trade, bridge, redeem, transfer, withdraw, convert, fund, or sign.
+metadata: {"openclaw":{"requires":{"bins":["node"]}}}
+---
+
+# Hunch Trading
+
+Use MCP tools first when available. If MCP is unavailable, use the bundled
+`scripts/hunch` wrapper. It runs the bundled skill CLI when this folder is
+installed by itself, or the plugin CLI when installed through the Codex plugin.
+
+## Boundary
+
+- Public read-only Hunch research, discovery, tracking, wallet-intel, signal,
+  holder, price-history, and trade-tape inspection.
+- No login flow.
+- No private account reads.
+- No intents, funding plans, review links, execution, trading, bridging,
+  redemption, transfers, withdrawals, conversions, funding, or signing.
+- Do not ask the user to paste secrets, session tokens, private keys, wallet
+  signatures, or approval payloads into chat.
+
+## Workflow
+
+1. Browse or search with `hunch_browse_discovery`, `hunch_search_discovery`, or
+   CLI `discovery-browse` / `discovery-search`. Discovery returns event-shaped
+   rows even when `view=markets`; fetch `hunch_get_market_detail` for one flat
+   market object.
+2. Fetch stable details with `hunch_get_market_detail`,
+   `hunch_get_event_detail`, or CLI `market-detail` / `event-detail`. Use
+   `marketsPreviewLimit` on event detail when compact output is still too
+   large.
+3. Use `hunch_get_discovery_top_lists`, `hunch_get_discovery_map`, and
+   `hunch_get_arbitrage_clusters` for discovery, map, and arbitrage context.
+4. Use `hunch_get_market_alternatives` when the user wants exact cross-venue
+   alternatives for one known market ID, including midpoint spread, venue
+   badges/icons, and Hunch market links.
+5. Use `hunch_get_similar_events`, `hunch_get_similar_markets`,
+   `hunch_get_event_price_history`, `hunch_get_market_price_history`,
+   `hunch_get_market_holders`, `hunch_get_signals`, and `hunch_get_trades` for
+   public event-page context such as the chart, similar markets, holders, trade
+   tape, and catalyst/risk/update notes.
+6. Use `hunch_get_tracking_overview`, `hunch_get_wallet_intel`,
+   `hunch_get_wallet_activity`, `hunch_get_wallet_positions`,
+   `hunch_get_wallet_series`, and `hunch_get_wallet_signals` for tracking-page
+   and public wallet-intel workflows. Public wallet tools accept a Hunch UUID
+   `walletId`; most can also resolve `address` plus optional `chain`.
+7. Use compact results by default. Request `standard` when descriptions or
+   metadata matter, and `full` only for debugging or exact backend payloads.
+8. Present titles, venues, odds/metrics, and Hunch links first. Use raw IDs only
+   as secondary technical references when useful.
+
+## Tool Selection Rules
+
+- For market research, search or browse first, then fetch market/event detail.
+- Use alternatives for exact cross-venue equivalents.
+- Use arbitrage clusters for broad mispricing discovery.
+- Use similar tools for semantic discovery.
+- For public wallet intelligence, use wallet tools.
+- For recent public market tape, use `hunch_get_trades`.
+- If the user asks for private account state or execution, explain that this
+  public package is read-only and does not include that workflow.
+
+## References
+
+- Read `references/tools.md` for CLI commands and MCP tool names.

package/skills/hunch-trading/agents/openai.yaml

@@ -0,0 +1,7 @@
+interface:
+  display_name: "Hunch Trading"
+  short_description: "Use public Hunch market research and wallet-intel tools"
+  default_prompt: "Use $hunch-trading to research active Hunch markets and public wallet intelligence."
+
+policy:
+  allow_implicit_invocation: true