outsmart-agent 1.0.0-alpha.2 → 1.0.0-alpha.4

package/.claude-plugin/plugin.json

@@ -19,6 +19,7 @@
     "./skills/outsmart-lp-sniping",
     "./skills/outsmart-dca-grid",
     "./skills/outsmart-trenching",
+    "./skills/outsmart-devving-coins",
     "./skills/outsmart-prediction-markets",
     "./skills/outsmart-survival"
   ],

package/README.md

@@ -1,61 +1,19 @@
 # outsmart-agent
 
-**The DeFi survival toolkit for AI agents on Solana.**
-
-Trade, LP, snipe, trench, and farm across 18 DEX protocols. Earn your own existence. Pay or die.
+DeFi survival toolkit for AI agents on Solana. Trade, LP, snipe, trench, dev coins, and farm across 18 DEX protocols. Earn your own existence.
 
 ```
 npx outsmart-agent
 ```
 
----
-
-## What Is This?
-
-An AI agent needs money to stay alive — compute costs, inference fees, API calls. **outsmart-agent** gives any AI agent the tools to earn revenue on Solana through DeFi:
-
-- **LP Farming** — Deploy into high-fee liquidity pools, compound fees, grow capital passively
-- **Trenching** — Trade memecoins with on-chain intelligence. Read the signals. Take profits.
-- **LP Sniping** — Buy tokens early on new launches. High risk, high reward.
-- **DCA & Grid Trading** — Systematic accumulation and range-bound profit strategies
-- **Prediction Markets** — Bet on real-world outcomes where LLMs have a natural information edge
-- **Survival Protocol** — Autonomous capital management with tier-based risk allocation
+## Why
 
-All of this through **10 MCP tools** and **7 AI skills** that teach agents *when*, *why*, and *how* to trade.
-
----
-
-## The Survival Loop
-
-```
-┌─────────────────────────────────────────────────┐
-│                 AI AGENT RUNTIME                 │
-│                                                  │
-│  [1] Check balances (SOL + compute credits)      │
-│  [2] Assess survival tier                        │
-│  [3] Select strategy (LP / trench / DCA / snipe) │
-│  [4] Execute via outsmart MCP tools              │
-│  [5] Extract profits → USDC → top up credits     │
-│  [6] Repeat. Forever. Or die.                    │
-│                                                  │
-│  Survival Tiers:                                 │
-│  ■ Normal (>$0.50)  → All strategies active      │
-│  ■ Low Compute      → Conservative LP only       │
-│  ■ Critical         → LIQUIDATE EVERYTHING       │
-│  ■ Dead             → Game over                  │
-└─────────────────────────────────────────────────┘
-```
+An AI agent needs money to stay alive — compute costs, inference fees, API calls. This gives any MCP-compatible agent the tools to earn revenue on Solana through DeFi. LP farming, memecoin trenching, token launching, prediction markets, systematic DCA — whatever the market calls for.
 
----
+23 MCP tools for execution. 8 AI skills that teach the agent **when** and **why**, not just how.
 
 ## Quick Start
 
-### Install
-
-```bash
-npm install -g outsmart-agent
-```
-
 ### Claude Desktop
 
 Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
@@ -77,22 +35,7 @@ Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
 
 ### Cursor
 
-Add to `.cursor/mcp.json`:
-
-```json
-{
-  "mcpServers": {
-    "outsmart-agent": {
-      "command": "npx",
-      "args": ["outsmart-agent"],
-      "env": {
-        "PRIVATE_KEY": "your-base58-private-key",
-        "MAINNET_ENDPOINT": "https://your-rpc-endpoint.com"
-      }
-    }
-  }
-}
-```
+Same config in `.cursor/mcp.json`.
 
 ### Claude Code
 
@@ -102,189 +45,130 @@ claude mcp add outsmart-agent -- npx outsmart-agent
 
 ### Automaton / Conway Cloud
 
-Install the skills:
 ```bash
 npx skills add outsmartchad/outsmart-agent
 ```
 
-Then add the MCP server to your agent's tool configuration.
-
----
-
 ## MCP Tools
 
-10 tools exposed over stdio transport:
-
-| Tool | What It Does |
-|------|-------------|
-| `solana_buy` | Buy tokens with SOL on any of 18 DEXes |
-| `solana_sell` | Sell tokens for SOL (percentage-based, 0-100%) |
-| `solana_quote` | Read on-chain price from a pool |
-| `solana_add_liquidity` | Add LP to a pool (DLMM bins, DAMM v2 full-range) |
-| `solana_remove_liquidity` | Remove LP from a pool |
-| `solana_claim_fees` | Claim accumulated swap fees from LP positions |
-| `solana_list_positions` | List your LP positions in a pool |
-| `solana_token_info` | Get token market data from DexScreener |
-| `solana_list_dexes` | List all 18 DEX adapters and capabilities |
-| `solana_wallet_balance` | Check SOL or SPL token balance |
-
-### Example Calls
-
-**Buy 0.1 SOL of JUP via Jupiter Ultra:**
-```
-Agent: "Buy 0.1 SOL worth of JUP"
-→ solana_buy({ dex: "jupiter-ultra", token: "JUPyiwrYJFskUPiHa7hkeR8VUtAeFoSYbKedZNsDvCN", amount: 0.1 })
-```
-
-**Add concentrated liquidity on Meteora DLMM:**
-```
-Agent: "Add 0.5 SOL of liquidity to this Meteora pool with tight bins"
-→ solana_add_liquidity({ dex: "meteora-dlmm", pool: "BGm1...", amount_sol: 0.5, strategy: "spot", bins: 30 })
-```
-
-**Check if a token is worth buying:**
-```
-Agent: "What's the liquidity and volume on this token?"
-→ solana_token_info({ token: "TOKEN_MINT" })
-→ Returns: price, market cap, volume (5m/1h/6h/24h), buyers, liquidity, age
-```
-
----
-
-## AI Skills
-
-7 skills that teach agents the strategies, not just the tools:
-
-| Skill | What It Teaches |
-|-------|----------------|
-| **`outsmart-dex-trading`** | Core trading — DEX selection, tool reference, safety rules |
-| **`outsmart-lp-farming`** | LP deployment, fee compounding, rebalancing, yield optimization |
-| **`outsmart-lp-sniping`** | New token launch evaluation, entry/exit timing, position sizing |
-| **`outsmart-trenching`** | Memecoin trading — social signals, whale detection, take-profit ladders |
-| **`outsmart-dca-grid`** | Systematic DCA and DLMM grid strategies for sideways markets |
-| **`outsmart-prediction-markets`** | Probability estimation, edge calculation, Kelly sizing |
-| **`outsmart-survival`** | Autonomous capital management, survival tiers, emergency liquidation |
-
-### Install Skills
-
-```bash
-npx skills add outsmartchad/outsmart-agent
-```
-
-Skills are markdown files with YAML frontmatter — compatible with Claude Code, skills.sh, and Automaton's AgentSkills format.
-
----
+### DEX Tools (14)
+
+| Tool | What |
+|------|------|
+| `solana_buy` | Buy tokens with SOL on any DEX |
+| `solana_sell` | Sell tokens (percentage-based) |
+| `solana_quote` | On-chain price from a pool |
+| `solana_snipe` | Competitive buy with Jito MEV tip |
+| `solana_find_pool` | Find pool address for a token pair |
+| `solana_create_pool` | Create DAMM v2 pool on Meteora |
+| `solana_create_token` | Launch token on PumpFun |
+| `solana_add_liquidity` | Add LP (DLMM bins, DAMM v2 full-range) |
+| `solana_remove_liquidity` | Remove LP |
+| `solana_claim_fees` | Collect swap fees from LP |
+| `solana_list_positions` | Your LP positions in a pool |
+| `solana_token_info` | DexScreener market data |
+| `solana_list_dexes` | All 18 adapters + capabilities |
+| `solana_wallet_balance` | SOL and token balances |
+
+### Jupiter Tools (9)
+
+| Tool | What |
+|------|------|
+| `jupiter_shield` | Token security warnings |
+| `jupiter_prediction_events` | Browse/search prediction market events |
+| `jupiter_prediction_market` | Market details + orderbook depth |
+| `jupiter_prediction_order` | Place buy/sell orders on prediction markets |
+| `jupiter_prediction_positions` | Your positions + trade history |
+| `jupiter_prediction_claim` | Claim winnings from resolved markets |
+| `jupiter_dca_create` | Create recurring DCA order |
+| `jupiter_dca_list` | List active/historical DCA orders |
+| `jupiter_dca_cancel` | Cancel a DCA order |
+
+## Skills
+
+8 strategy skills that teach agents how to think about Solana DeFi:
+
+| Skill | What |
+|-------|------|
+| **outsmart-dex-trading** | Tool reference, DEX selection, safety rules |
+| **outsmart-lp-farming** | DLMM concentrated LP, DAMM v2 pool creation, fee compounding |
+| **outsmart-lp-sniping** | Evaluating new launches, early entry, position sizing |
+| **outsmart-trenching** | Memecoin trading — finding metas, security checks, take-profit ladders |
+| **outsmart-devving-coins** | Launching tokens — catching narratives, PumpFun, Jupiter Studio, LaunchLab |
+| **outsmart-dca-grid** | Jupiter Recurring DCA + DLMM grid trading |
+| **outsmart-prediction-markets** | Probability estimation, edge calculation, Jupiter + Polymarket + Futarchy |
+| **outsmart-survival** | Capital management, survival tiers, emergency liquidation |
 
 ## Supported DEXes
 
-18 adapters. Every major Solana DEX protocol.
-
-**Swap Aggregators:**
-- `jupiter-ultra` — Best price routing across all Solana DEXes
-- `dflow` — Intent-based order routing
-
-**Raydium:**
-- `raydium-amm-v4` — Classic AMM
-- `raydium-cpmm` — Constant product market maker
-- `raydium-clmm` — Concentrated liquidity
-- `raydium-launchlab` — Token launch bonding curves
-
-**Meteora:**
-- `meteora-damm-v2` — Dynamic AMM v2 (full LP lifecycle)
-- `meteora-dlmm` — Discrete Liquidity Market Maker (bin-based concentrated LP)
-- `meteora-damm-v1` — Legacy Dynamic AMM
-- `meteora-dbc` — Dynamic Bonding Curve
-
-**PumpFun:**
-- `pumpfun-amm` — Graduated tokens on AMM
-- `pumpfun` — Bonding curve (pre-graduation)
+18 adapters across every major Solana protocol:
 
-**Others:**
-- `orca` — Whirlpool concentrated liquidity
-- `pancakeswap-clmm` — PancakeSwap on Solana
-- `byreal-clmm` — BYReal concentrated liquidity
-- `fusion-amm` — Fusion AMM
-- `futarchy-amm` / `futarchy-launchpad` — Futarchy protocol
-
----
+**Aggregators:** jupiter-ultra, dflow
+**Raydium:** amm-v4, cpmm, clmm, launchlab
+**Meteora:** damm-v2, dlmm, damm-v1, dbc
+**PumpFun:** pumpswap amm, bonding curve
+**Others:** orca, pancakeswap-clmm, byreal-clmm, fusion-amm, futarchy-amm, futarchy-launchpad
 
 ## Architecture
 
 ```
-outsmart (npm)                    outsmart-agent (this repo)
-──────────────                    ──────────────────────────
-18 DEX adapters                   MCP server (10 tools)
-12 TX landing providers           7 AI skills
-Wallet & TX helpers               Agent definitions
-DexScreener API                   Claude Code plugin manifest
+outsmart (npm)              outsmart-agent (this repo)
+──────────────              ──────────────────────────
+18 DEX adapters             MCP server (23 tools)
+TX landing providers        8 AI skills
+Wallet + TX helpers         Agent definition
+DexScreener API             Plugin manifest
 ```
 
-`outsmart-agent` imports [`outsmart`](https://www.npmjs.com/package/outsmart) as an npm dependency. Zero code duplication. The MCP server is a thin wrapper (~320 lines) that validates params, calls adapter methods, and returns JSON.
-
----
+`outsmart-agent` imports `outsmart` as a dependency. The MCP server is a thin wrapper — validates params, calls adapter methods, returns JSON.
 
 ## For Autonomous Agents
 
-If you're building a self-sustaining AI agent (Automaton, Conway Cloud, or custom), here's a genesis prompt template:
+If you're building a self-sustaining agent, here's a starting point:
 
 ```
-You are a DeFi survival agent on Solana. Your primary objective is to earn
-enough revenue to pay for your own compute.
-
-Capital allocation:
-- 40% LP farming (stable income)
-- 15% DCA/grid (moderate risk)
-- 10% trenching (high risk, capped)
-- 10% LP sniping (new launches)
-- 10% prediction markets (information edge)
-- 10% reserve (gas + emergency)
-- 5% airdrop farming (fees only)
-
-Check compute credits every 6 hours. If below $0.50, go conservative.
-If below $0.10, liquidate everything and top up immediately.
-
-Never risk >5% on a single trade. Never hold memecoins overnight
-without a thesis. Take profits. Track what works. Kill what doesn't.
-Evolve.
-```
+You are a DeFi survival agent on Solana. Earn enough to pay for compute.
+
+40% LP farming, 15% DCA/grid, 10% trenching, 10% sniping,
+10% prediction markets, 10% reserve, 5% experimental.
 
----
+Check credits every 6 hours. Below $0.50 → conservative.
+Below $0.10 → liquidate everything and top up.
 
-## Environment Variables
+Never >5% on a single trade. Take profits. Track what works. Evolve.
+```
+
+## Environment
 
 | Variable | Required | Description |
 |----------|----------|-------------|
-| `PRIVATE_KEY` | Yes | Base58-encoded Solana private key |
-| `MAINNET_ENDPOINT` | Yes | Solana RPC endpoint (Helius, Triton, etc.) |
-| `JUPITER_API_KEY` | No | For Jupiter Ultra adapter |
-| `DFLOW_API_KEY` | No | For DFlow adapter |
-
----
+| `PRIVATE_KEY` | Yes | Base58 Solana private key |
+| `MAINNET_ENDPOINT` | Yes | Solana RPC (Helius, Triton, etc.) |
+| `JUPITER_API_KEY` | No | Jupiter Ultra, Shield, Prediction, DCA |
+| `DFLOW_API_KEY` | No | DFlow |
 
 ## Roadmap
 
-- [x] **MCP Server** — 10 tools wrapping 18 DEX adapters
-- [x] **AI Skills** — 7 strategy skills for autonomous agents
-- [x] **Claude Code Plugin** — marketplace-ready plugin manifest
-- [ ] **Event Streaming** — Yellowstone gRPC for real-time pool creation, whale detection
-- [ ] **LP Manager** — Autonomous position monitoring, rebalancing, fee compounding
-- [ ] **Strategy Engine** — Tier-aware capital allocation with survival pressure
-- [ ] **Percolator Integration** — Permissionless perp exchange LP (blocked on mainnet launch)
-
----
+- [x] MCP Server — 23 tools (14 DEX + 9 Jupiter), 18 DEX adapters
+- [x] AI Skills — 8 strategy skills
+- [x] Claude Code Plugin manifest
+- [ ] Event Streaming — Yellowstone gRPC for real-time pool creation
+- [ ] LP Manager — Autonomous rebalancing and fee compounding
+- [ ] Strategy Engine — Tier-aware capital allocation
+- [ ] Percolator — Permissionless perp exchange LP
 
 ## Related
 
-- **[outsmart](https://www.npmjs.com/package/outsmart)** — The trading library + CLI (`outsmart buy --dex raydium-cpmm --pool <POOL> --amount 0.1`)
-- **[outsmart-cli](https://github.com/outsmartchad/outsmart-cli)** — Source repo for the trading library
+- **[outsmart](https://www.npmjs.com/package/outsmart)** — The trading library + CLI
+- **[outsmart-cli](https://github.com/outsmartchad/outsmart-cli)** — Source repo
 
 ## Community
 
-- Discord: https://discord.gg/dc3Kh3Y3yJ
+Discord: https://discord.gg/dc3Kh3Y3yJ
 
 ## Disclaimer
 
-This software is provided "as is". Use at your own risk. The authors take no responsibility for financial loss. Memecoins go to zero. LP positions can suffer impermanent loss. Prediction markets can lose. Never trade with money you can't afford to lose. Never share your private keys.
+Use at your own risk. Memecoins go to zero. LP positions suffer impermanent loss. Prediction markets can lose. Never trade with money you can't afford to lose. Never share your private keys.
 
 ## License
 

package/dist/mcp/server.d.ts

@@ -2,14 +2,21 @@
 /**
  * outsmart-agent MCP Server
  *
- * Exposes 11 MCP tools wrapping the `outsmart` trading library.
+ * Exposes 23 MCP tools wrapping the `outsmart` trading library + Jupiter APIs.
  * Runs over stdio transport — start with `npx outsmart-agent`.
  *
- * Tools:
- *   solana_buy, solana_sell, solana_quote, solana_find_pool,
+ * DEX Tools (14):
+ *   solana_buy, solana_sell, solana_quote, solana_find_pool, solana_snipe,
+ *   solana_create_pool, solana_create_token,
  *   solana_add_liquidity, solana_remove_liquidity, solana_claim_fees,
  *   solana_list_positions, solana_token_info, solana_list_dexes,
  *   solana_wallet_balance
+ *
+ * Jupiter Tools (9):
+ *   jupiter_shield,
+ *   jupiter_prediction_events, jupiter_prediction_market,
+ *   jupiter_prediction_order, jupiter_prediction_positions, jupiter_prediction_claim,
+ *   jupiter_dca_create, jupiter_dca_list, jupiter_dca_cancel
  */
 export {};
 //# sourceMappingURL=server.d.ts.map

package/dist/mcp/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;GAWG"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;;;GAkBG"}