outsmart-agent 1.0.0-alpha.1

package/LICENSE

@@ -0,0 +1,15 @@
+ISC License
+
+Copyright (c) 2026 vincent so
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
+REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
+AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
+INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
+LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
+OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
+PERFORMANCE OF THIS SOFTWARE.

package/README.md

@@ -0,0 +1,204 @@
+# outsmart-agent
+
+**MCP server + AI skills for Solana trading.** Wraps the [`outsmart`](https://www.npmjs.com/package/outsmart) trading library as 11 MCP tools for AI agents.
+
+```
+npx outsmart-agent
+```
+
+> Starts an MCP server (stdio transport) exposing buy, sell, LP, quote, and balance tools across 18 Solana DEX protocols.
+
+---
+
+## Quick Start
+
+### 1. Install
+
+```bash
+npm install -g outsmart-agent
+```
+
+### 2. Set Environment Variables
+
+```bash
+export WALLET_PRIVATE_KEY="your-base58-private-key"
+export RPC_URL="https://your-rpc-endpoint.com"
+# Optional:
+export JUPITER_API_KEY="your-jupiter-api-key"
+```
+
+### 3. Configure Your MCP Client
+
+#### Claude Desktop
+
+Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "outsmart-agent": {
+      "command": "npx",
+      "args": ["outsmart-agent"],
+      "env": {
+        "WALLET_PRIVATE_KEY": "your-base58-private-key",
+        "RPC_URL": "https://your-rpc-endpoint.com"
+      }
+    }
+  }
+}
+```
+
+#### Cursor
+
+Add to `.cursor/mcp.json` in your project:
+
+```json
+{
+  "mcpServers": {
+    "outsmart-agent": {
+      "command": "npx",
+      "args": ["outsmart-agent"],
+      "env": {
+        "WALLET_PRIVATE_KEY": "your-base58-private-key",
+        "RPC_URL": "https://your-rpc-endpoint.com"
+      }
+    }
+  }
+}
+```
+
+#### Claude Code
+
+```bash
+claude mcp add outsmart-agent -- npx outsmart-agent
+```
+
+---
+
+## MCP Tools
+
+10 tools exposed over stdio transport:
+
+| Tool | Description |
+|------|-------------|
+| `solana_buy` | Buy tokens with SOL on any DEX |
+| `solana_sell` | Sell tokens for SOL (percentage-based) |
+| `solana_quote` | Get on-chain price from a pool |
+| `solana_add_liquidity` | Add LP to a pool (supports DLMM strategies) |
+| `solana_remove_liquidity` | Remove LP from a pool |
+| `solana_claim_fees` | Claim accumulated swap fees from LP positions |
+| `solana_list_positions` | List user's LP positions in a pool |
+| `solana_token_info` | Get token market data from DexScreener |
+| `solana_list_dexes` | List all available DEX adapters and capabilities |
+| `solana_wallet_balance` | Check SOL or SPL token balance |
+
+### Example: Buy a Token
+
+```
+User: "Buy 0.1 SOL of USDC on jupiter-ultra"
+
+Agent calls: solana_buy({
+  dex: "jupiter-ultra",
+  token: "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
+  amount: 0.1
+})
+```
+
+### Example: Provide Liquidity
+
+```
+User: "Add 0.5 SOL of liquidity to this Meteora DLMM pool"
+
+Agent calls: solana_add_liquidity({
+  dex: "meteora-dlmm",
+  pool: "BGm1tav58oGcsQJehL9WXBFXF7D27vZsKefj4xJKD5Y",
+  amount_sol: 0.5,
+  strategy: "spot",
+  bins: 50
+})
+```
+
+---
+
+## Supported DEXes
+
+18 adapters covering every major Solana DEX protocol:
+
+**Swap Aggregators** (best price routing):
+- `jupiter-ultra` — Jupiter Ultra API
+- `dflow` — DFlow intent-based routing
+
+**On-Chain DEXes** (direct pool execution):
+- `raydium-amm-v4`, `raydium-cpmm`, `raydium-clmm`, `raydium-launchlab`
+- `meteora-damm-v2`, `meteora-dlmm`, `meteora-damm-v1`, `meteora-dbc`
+- `pumpfun-amm`
+- `orca`
+- `byreal-clmm`, `pancakeswap-clmm`
+- `fusion-amm`, `futarchy-amm`, `futarchy-launchpad`
+
+**LP Management** (add/remove/claim):
+- `meteora-damm-v2` — Full LP lifecycle
+- `meteora-dlmm` (via `meteora-lp-dlmm`) — Concentrated LP with bin strategies
+
+---
+
+## AI Skills
+
+This package includes a trading skill at `skills/outsmart/SKILL.md` compatible with the [skills.sh](https://skills.sh) CLI:
+
+```bash
+npx skills add outsmartchad/outsmart-agent
+```
+
+The skill teaches AI agents:
+- Which DEX to use for different scenarios
+- How to check token safety before trading
+- Common workflows (buy, sell, LP, exit)
+- Safety rules for autonomous trading
+
+---
+
+## Architecture
+
+```
+outsmart (npm package)           outsmart-agent (this repo)
+──────────────────────           ─────────────────────────
+18 DEX adapters                  MCP server (11 tools)
+12 TX landing providers          AI skills (SKILL.md)
+Wallet/connection helpers        Claude Code marketplace plugin
+DexScreener utility              Re-exports outsmart API
+```
+
+`outsmart-agent` imports `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 results.
+
+---
+
+## Environment Variables
+
+| Variable | Required | Description |
+|----------|----------|-------------|
+| `WALLET_PRIVATE_KEY` | Yes | Base58-encoded Solana private key |
+| `RPC_URL` | Yes | Solana RPC endpoint |
+| `JUPITER_API_KEY` | No | For jupiter-ultra adapter |
+| `DFLOW_API_KEY` | No | For dflow adapter |
+
+---
+
+## Related
+
+- **[outsmart](https://www.npmjs.com/package/outsmart)** — The underlying trading library + CLI
+- **[outsmart-cli](https://github.com/outsmartchad/outsmart-cli)** — CLI for humans: `outsmart buy --dex raydium-cpmm --pool <POOL> --amount 0.1`
+
+## Discord
+
+https://discord.gg/dc3Kh3Y3yJ
+
+## Disclaimer
+
+This software is provided "as is", without warranty of any kind. Use at your own risk. The authors take no responsibility for any financial loss. Users are responsible for ensuring compliance with applicable laws.
+
+Never share your private keys.
+
+## License
+
+ISC

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * outsmart-agent — Library Entry Point
+ *
+ * Re-exports the outsmart trading library and the MCP server starter.
+ * Consumers can either:
+ *   1. `npx outsmart-agent` — starts the MCP server (stdio transport)
+ *   2. `import { ... } from "outsmart-agent"` — use as a library
+ */
+export { DexRegistry, getRegistry, getDexAdapter, listDexAdapters, registerAdapter, registerAllAdapters, type IDexAdapter, type DexAdapterInfo, type DexCapabilities, type BuyParams, type SellParams, type SnipeParams, type SwapOpts, type SwapResult, type PoolInfo, type PriceInfo, type TxResult, type BuildSwapIxsResult, type AddLiquidityParams, type RemoveLiquidityParams, type SwapSide, UnsupportedOperationError, PoolNotFoundError, defaultCapabilities, WSOL_MINT, USDC_MINT, USDT_MINT, DEFAULT_SLIPPAGE_BPS, DEFAULT_PRIORITY_FEE_MICRO_LAMPORTS, DEFAULT_COMPUTE_UNIT_LIMIT, type ILandingProvider, type LandingResult, type SubmitOptions, type SubmissionStrategy, type OrchestratorConfig, type TipAccount, getWallet, getConnection, resetWalletCache, checkBalanceByAddress, getSPLTokenBalance, sendAndConfirmVtx, sendAndConfirmLegacyTx, setDryRunMode, isDryRunMode, type SendRpcOptions, type SendRpcResult, type SendLegacyTxOptions, getInfoFromDexscreener, } from "outsmart";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAEL,WAAW,EACX,WAAW,EACX,aAAa,EACb,eAAe,EACf,eAAe,EACf,mBAAmB,EAGnB,KAAK,WAAW,EAChB,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,SAAS,EACd,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,KAAK,QAAQ,EACb,KAAK,UAAU,EACf,KAAK,QAAQ,EACb,KAAK,SAAS,EACd,KAAK,QAAQ,EACb,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,qBAAqB,EAC1B,KAAK,QAAQ,EAGb,yBAAyB,EACzB,iBAAiB,EACjB,mBAAmB,EACnB,SAAS,EACT,SAAS,EACT,SAAS,EACT,oBAAoB,EACpB,mCAAmC,EACnC,0BAA0B,EAG1B,KAAK,gBAAgB,EACrB,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,UAAU,EAGf,SAAS,EACT,aAAa,EACb,gBAAgB,EAChB,qBAAqB,EACrB,kBAAkB,EAGlB,iBAAiB,EACjB,sBAAsB,EACtB,aAAa,EACb,YAAY,EACZ,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,mBAAmB,EAGxB,sBAAsB,GACvB,MAAM,UAAU,CAAC"}

package/dist/index.js

@@ -0,0 +1,44 @@
+"use strict";
+/**
+ * outsmart-agent — Library Entry Point
+ *
+ * Re-exports the outsmart trading library and the MCP server starter.
+ * Consumers can either:
+ *   1. `npx outsmart-agent` — starts the MCP server (stdio transport)
+ *   2. `import { ... } from "outsmart-agent"` — use as a library
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getInfoFromDexscreener = exports.isDryRunMode = exports.setDryRunMode = exports.sendAndConfirmLegacyTx = exports.sendAndConfirmVtx = exports.getSPLTokenBalance = exports.checkBalanceByAddress = exports.resetWalletCache = exports.getConnection = exports.getWallet = exports.DEFAULT_COMPUTE_UNIT_LIMIT = exports.DEFAULT_PRIORITY_FEE_MICRO_LAMPORTS = exports.DEFAULT_SLIPPAGE_BPS = exports.USDT_MINT = exports.USDC_MINT = exports.WSOL_MINT = exports.defaultCapabilities = exports.PoolNotFoundError = exports.UnsupportedOperationError = exports.registerAllAdapters = exports.registerAdapter = exports.listDexAdapters = exports.getDexAdapter = exports.getRegistry = exports.DexRegistry = void 0;
+// Re-export everything from the outsmart trading library
+var outsmart_1 = require("outsmart");
+// DEX registry
+Object.defineProperty(exports, "DexRegistry", { enumerable: true, get: function () { return outsmart_1.DexRegistry; } });
+Object.defineProperty(exports, "getRegistry", { enumerable: true, get: function () { return outsmart_1.getRegistry; } });
+Object.defineProperty(exports, "getDexAdapter", { enumerable: true, get: function () { return outsmart_1.getDexAdapter; } });
+Object.defineProperty(exports, "listDexAdapters", { enumerable: true, get: function () { return outsmart_1.listDexAdapters; } });
+Object.defineProperty(exports, "registerAdapter", { enumerable: true, get: function () { return outsmart_1.registerAdapter; } });
+Object.defineProperty(exports, "registerAllAdapters", { enumerable: true, get: function () { return outsmart_1.registerAllAdapters; } });
+// Constants & errors
+Object.defineProperty(exports, "UnsupportedOperationError", { enumerable: true, get: function () { return outsmart_1.UnsupportedOperationError; } });
+Object.defineProperty(exports, "PoolNotFoundError", { enumerable: true, get: function () { return outsmart_1.PoolNotFoundError; } });
+Object.defineProperty(exports, "defaultCapabilities", { enumerable: true, get: function () { return outsmart_1.defaultCapabilities; } });
+Object.defineProperty(exports, "WSOL_MINT", { enumerable: true, get: function () { return outsmart_1.WSOL_MINT; } });
+Object.defineProperty(exports, "USDC_MINT", { enumerable: true, get: function () { return outsmart_1.USDC_MINT; } });
+Object.defineProperty(exports, "USDT_MINT", { enumerable: true, get: function () { return outsmart_1.USDT_MINT; } });
+Object.defineProperty(exports, "DEFAULT_SLIPPAGE_BPS", { enumerable: true, get: function () { return outsmart_1.DEFAULT_SLIPPAGE_BPS; } });
+Object.defineProperty(exports, "DEFAULT_PRIORITY_FEE_MICRO_LAMPORTS", { enumerable: true, get: function () { return outsmart_1.DEFAULT_PRIORITY_FEE_MICRO_LAMPORTS; } });
+Object.defineProperty(exports, "DEFAULT_COMPUTE_UNIT_LIMIT", { enumerable: true, get: function () { return outsmart_1.DEFAULT_COMPUTE_UNIT_LIMIT; } });
+// Helpers
+Object.defineProperty(exports, "getWallet", { enumerable: true, get: function () { return outsmart_1.getWallet; } });
+Object.defineProperty(exports, "getConnection", { enumerable: true, get: function () { return outsmart_1.getConnection; } });
+Object.defineProperty(exports, "resetWalletCache", { enumerable: true, get: function () { return outsmart_1.resetWalletCache; } });
+Object.defineProperty(exports, "checkBalanceByAddress", { enumerable: true, get: function () { return outsmart_1.checkBalanceByAddress; } });
+Object.defineProperty(exports, "getSPLTokenBalance", { enumerable: true, get: function () { return outsmart_1.getSPLTokenBalance; } });
+// TX send
+Object.defineProperty(exports, "sendAndConfirmVtx", { enumerable: true, get: function () { return outsmart_1.sendAndConfirmVtx; } });
+Object.defineProperty(exports, "sendAndConfirmLegacyTx", { enumerable: true, get: function () { return outsmart_1.sendAndConfirmLegacyTx; } });
+Object.defineProperty(exports, "setDryRunMode", { enumerable: true, get: function () { return outsmart_1.setDryRunMode; } });
+Object.defineProperty(exports, "isDryRunMode", { enumerable: true, get: function () { return outsmart_1.isDryRunMode; } });
+// DexScreener
+Object.defineProperty(exports, "getInfoFromDexscreener", { enumerable: true, get: function () { return outsmart_1.getInfoFromDexscreener; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;AAEH,yDAAyD;AACzD,qCA+DkB;AA9DhB,eAAe;AACf,uGAAA,WAAW,OAAA;AACX,uGAAA,WAAW,OAAA;AACX,yGAAA,aAAa,OAAA;AACb,2GAAA,eAAe,OAAA;AACf,2GAAA,eAAe,OAAA;AACf,+GAAA,mBAAmB,OAAA;AAmBnB,qBAAqB;AACrB,qHAAA,yBAAyB,OAAA;AACzB,6GAAA,iBAAiB,OAAA;AACjB,+GAAA,mBAAmB,OAAA;AACnB,qGAAA,SAAS,OAAA;AACT,qGAAA,SAAS,OAAA;AACT,qGAAA,SAAS,OAAA;AACT,gHAAA,oBAAoB,OAAA;AACpB,+HAAA,mCAAmC,OAAA;AACnC,sHAAA,0BAA0B,OAAA;AAU1B,UAAU;AACV,qGAAA,SAAS,OAAA;AACT,yGAAA,aAAa,OAAA;AACb,4GAAA,gBAAgB,OAAA;AAChB,iHAAA,qBAAqB,OAAA;AACrB,8GAAA,kBAAkB,OAAA;AAElB,UAAU;AACV,6GAAA,iBAAiB,OAAA;AACjB,kHAAA,sBAAsB,OAAA;AACtB,yGAAA,aAAa,OAAA;AACb,wGAAA,YAAY,OAAA;AAKZ,cAAc;AACd,kHAAA,sBAAsB,OAAA"}

package/dist/mcp/server.d.ts

@@ -0,0 +1,15 @@
+#!/usr/bin/env node
+/**
+ * outsmart-agent MCP Server
+ *
+ * Exposes 11 MCP tools wrapping the `outsmart` trading library.
+ * Runs over stdio transport — start with `npx outsmart-agent`.
+ *
+ * Tools:
+ *   solana_buy, solana_sell, solana_quote, solana_find_pool,
+ *   solana_add_liquidity, solana_remove_liquidity, solana_claim_fees,
+ *   solana_list_positions, solana_token_info, solana_list_dexes,
+ *   solana_wallet_balance
+ */
+export {};
+//# sourceMappingURL=server.d.ts.map

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

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

package/dist/mcp/server.js

@@ -0,0 +1,305 @@
+#!/usr/bin/env node
+"use strict";
+/**
+ * outsmart-agent MCP Server
+ *
+ * Exposes 11 MCP tools wrapping the `outsmart` trading library.
+ * Runs over stdio transport — start with `npx outsmart-agent`.
+ *
+ * Tools:
+ *   solana_buy, solana_sell, solana_quote, solana_find_pool,
+ *   solana_add_liquidity, solana_remove_liquidity, solana_claim_fees,
+ *   solana_list_positions, solana_token_info, solana_list_dexes,
+ *   solana_wallet_balance
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const mcp_js_1 = require("@modelcontextprotocol/sdk/server/mcp.js");
+const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
+const zod_1 = require("zod");
+const web3_js_1 = require("@solana/web3.js");
+const outsmart_1 = require("outsmart");
+// ---------------------------------------------------------------------------
+// Helper: get adapter with error handling
+// ---------------------------------------------------------------------------
+function getAdapter(dex) {
+    try {
+        return (0, outsmart_1.getDexAdapter)(dex);
+    }
+    catch (err) {
+        throw new Error(`DEX adapter "${dex}" not found. Use solana_list_dexes to see available adapters. ${err.message}`);
+    }
+}
+// ---------------------------------------------------------------------------
+// Helper: format tool result
+// ---------------------------------------------------------------------------
+function ok(data) {
+    return {
+        content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
+    };
+}
+function err(message) {
+    return {
+        content: [{ type: "text", text: JSON.stringify({ error: message }) }],
+        isError: true,
+    };
+}
+// ---------------------------------------------------------------------------
+// Server setup
+// ---------------------------------------------------------------------------
+const server = new mcp_js_1.McpServer({
+    name: "outsmart-agent",
+    version: "1.0.0-alpha.1",
+});
+// ---------------------------------------------------------------------------
+// Tool: solana_buy
+// ---------------------------------------------------------------------------
+// @ts-expect-error — TS2589: deep type instantiation from MCP SDK generics + zod
+server.tool("solana_buy", "Buy tokens with SOL on a Solana DEX. For aggregators (jupiter-ultra, dflow), provide 'token'. For on-chain DEXes (raydium-*, meteora-*, orca, etc.), provide 'pool'.", {
+    dex: zod_1.z.string().describe("DEX adapter name (e.g. 'jupiter-ultra', 'raydium-cpmm', 'meteora-dlmm')"),
+    pool: zod_1.z.string().optional().describe("Pool address (required for on-chain DEXes)"),
+    token: zod_1.z.string().optional().describe("Token mint address (required for aggregators)"),
+    amount: zod_1.z.number().positive().describe("Amount of SOL to spend"),
+    slippage_bps: zod_1.z.number().int().min(0).max(10000).optional().describe("Slippage tolerance in basis points (default: 300 = 3%)"),
+    tip_sol: zod_1.z.number().min(0).optional().describe("MEV tip in SOL"),
+    dry_run: zod_1.z.boolean().optional().describe("Simulate without sending (default: false)"),
+}, async (args) => {
+    try {
+        const adapter = getAdapter(args.dex);
+        const result = await adapter.buy({
+            tokenMint: args.token,
+            amountSol: args.amount,
+            poolAddress: args.pool,
+            opts: {
+                slippageBps: args.slippage_bps,
+                tipSol: args.tip_sol,
+                dryRun: args.dry_run,
+            },
+        });
+        return ok(result);
+    }
+    catch (e) {
+        return err(e.message);
+    }
+});
+// ---------------------------------------------------------------------------
+// Tool: solana_sell
+// ---------------------------------------------------------------------------
+server.tool("solana_sell", "Sell tokens for SOL on a Solana DEX. Specify percentage of holdings to sell (0-100).", {
+    dex: zod_1.z.string().describe("DEX adapter name"),
+    pool: zod_1.z.string().optional().describe("Pool address (required for on-chain DEXes)"),
+    token: zod_1.z.string().optional().describe("Token mint address (required for aggregators)"),
+    percentage: zod_1.z.number().min(0).max(100).describe("Percentage of token holdings to sell (100 = sell all)"),
+    slippage_bps: zod_1.z.number().int().min(0).max(10000).optional().describe("Slippage tolerance in basis points"),
+    dry_run: zod_1.z.boolean().optional().describe("Simulate without sending"),
+}, async (args) => {
+    try {
+        const adapter = getAdapter(args.dex);
+        const result = await adapter.sell({
+            tokenMint: args.token,
+            percentage: args.percentage,
+            poolAddress: args.pool,
+            opts: {
+                slippageBps: args.slippage_bps,
+                dryRun: args.dry_run,
+            },
+        });
+        return ok(result);
+    }
+    catch (e) {
+        return err(e.message);
+    }
+});
+// ---------------------------------------------------------------------------
+// Tool: solana_quote
+// ---------------------------------------------------------------------------
+server.tool("solana_quote", "Get the current on-chain price from a pool. Reads directly from on-chain state.", {
+    dex: zod_1.z.string().describe("DEX adapter name"),
+    pool: zod_1.z.string().describe("Pool address to read price from"),
+}, async (args) => {
+    try {
+        const adapter = getAdapter(args.dex);
+        if (!adapter.getPrice) {
+            return err(`${args.dex} does not support getPrice`);
+        }
+        const result = await adapter.getPrice(args.pool);
+        return ok(result);
+    }
+    catch (e) {
+        return err(e.message);
+    }
+});
+// ---------------------------------------------------------------------------
+// Tool: solana_add_liquidity
+// ---------------------------------------------------------------------------
+server.tool("solana_add_liquidity", "Add liquidity to a pool. Supports DLMM strategies (spot, curve, bid-ask) and bin configuration.", {
+    dex: zod_1.z.string().describe("DEX adapter name"),
+    pool: zod_1.z.string().describe("Pool address to add liquidity to"),
+    amount_sol: zod_1.z.number().min(0).optional().describe("Amount of SOL to deposit"),
+    amount_token: zod_1.z.number().min(0).optional().describe("Amount of the non-SOL token to deposit"),
+    token_mint: zod_1.z.string().optional().describe("Token mint (required for single-sided token deposits)"),
+    strategy: zod_1.z.enum(["spot", "curve", "bid-ask"]).optional().describe("Liquidity distribution strategy (DLMM only, default: spot)"),
+    bins: zod_1.z.number().int().min(1).max(70).optional().describe("Number of bins to spread across (DLMM only, default: 50)"),
+}, async (args) => {
+    try {
+        const adapter = getAdapter(args.dex);
+        if (!adapter.addLiquidity) {
+            return err(`${args.dex} does not support addLiquidity`);
+        }
+        const result = await adapter.addLiquidity({
+            poolAddress: args.pool,
+            amountSol: args.amount_sol,
+            amountToken: args.amount_token,
+            tokenMint: args.token_mint,
+            strategy: args.strategy,
+            bins: args.bins,
+        });
+        return ok(result);
+    }
+    catch (e) {
+        return err(e.message);
+    }
+});
+// ---------------------------------------------------------------------------
+// Tool: solana_remove_liquidity
+// ---------------------------------------------------------------------------
+server.tool("solana_remove_liquidity", "Remove liquidity from a pool. Specify percentage to withdraw (0-100).", {
+    dex: zod_1.z.string().describe("DEX adapter name"),
+    pool: zod_1.z.string().describe("Pool address"),
+    percentage: zod_1.z.number().min(0).max(100).describe("Percentage of LP position to remove (100 = withdraw all)"),
+    position_address: zod_1.z.string().optional().describe("Specific position address (if multiple positions exist)"),
+}, async (args) => {
+    try {
+        const adapter = getAdapter(args.dex);
+        if (!adapter.removeLiquidity) {
+            return err(`${args.dex} does not support removeLiquidity`);
+        }
+        const result = await adapter.removeLiquidity({
+            poolAddress: args.pool,
+            percentage: args.percentage,
+            positionAddress: args.position_address,
+        });
+        return ok(result);
+    }
+    catch (e) {
+        return err(e.message);
+    }
+});
+// ---------------------------------------------------------------------------
+// Tool: solana_claim_fees
+// ---------------------------------------------------------------------------
+server.tool("solana_claim_fees", "Claim accumulated swap fees from LP positions in a pool.", {
+    dex: zod_1.z.string().describe("DEX adapter name"),
+    pool: zod_1.z.string().describe("Pool address"),
+    position_address: zod_1.z.string().optional().describe("Specific position to claim from"),
+}, async (args) => {
+    try {
+        const adapter = getAdapter(args.dex);
+        if (!adapter.claimFees) {
+            return err(`${args.dex} does not support claimFees`);
+        }
+        const result = await adapter.claimFees(args.pool, args.position_address);
+        return ok(result);
+    }
+    catch (e) {
+        return err(e.message);
+    }
+});
+// ---------------------------------------------------------------------------
+// Tool: solana_list_positions
+// ---------------------------------------------------------------------------
+server.tool("solana_list_positions", "List user's LP positions in a pool. Shows token amounts, fee balances, and in-range status.", {
+    dex: zod_1.z.string().describe("DEX adapter name"),
+    pool: zod_1.z.string().describe("Pool address"),
+}, async (args) => {
+    try {
+        const adapter = getAdapter(args.dex);
+        if (!adapter.listPositions) {
+            return err(`${args.dex} does not support listPositions`);
+        }
+        const result = await adapter.listPositions(args.pool);
+        return ok(result);
+    }
+    catch (e) {
+        return err(e.message);
+    }
+});
+// ---------------------------------------------------------------------------
+// Tool: solana_token_info
+// ---------------------------------------------------------------------------
+server.tool("solana_token_info", "Get token market data from DexScreener — price, market cap, volume, liquidity, age, buyers, social links.", {
+    token: zod_1.z.string().describe("Token mint address (base58)"),
+}, async (args) => {
+    try {
+        const result = await (0, outsmart_1.getInfoFromDexscreener)(args.token);
+        return ok(result);
+    }
+    catch (e) {
+        return err(e.message);
+    }
+});
+// ---------------------------------------------------------------------------
+// Tool: solana_list_dexes
+// ---------------------------------------------------------------------------
+server.tool("solana_list_dexes", "List all available DEX adapters and their capabilities. Optionally filter by capability.", {
+    capability: zod_1.z
+        .string()
+        .optional()
+        .describe("Filter by capability: canBuy, canSell, canSnipe, canFindPool, canGetPrice, canAddLiquidity, canRemoveLiquidity, canClaimFees, canListPositions, canCreatePool, isAggregator"),
+}, async (args) => {
+    try {
+        let adapters = (0, outsmart_1.listDexAdapters)();
+        if (args.capability) {
+            adapters = adapters.filter((a) => a.capabilities[args.capability]);
+        }
+        return ok(adapters);
+    }
+    catch (e) {
+        return err(e.message);
+    }
+});
+// ---------------------------------------------------------------------------
+// Tool: solana_wallet_balance
+// ---------------------------------------------------------------------------
+server.tool("solana_wallet_balance", "Check SOL balance of the configured wallet. Optionally check a specific SPL token balance.", {
+    token_mint: zod_1.z.string().optional().describe("SPL token mint to check balance for (omit for SOL balance)"),
+}, async (args) => {
+    try {
+        const wallet = (0, outsmart_1.getWallet)();
+        const address = wallet.publicKey.toBase58();
+        if (args.token_mint) {
+            const connection = (0, outsmart_1.getConnection)();
+            const tokenMintPubkey = new web3_js_1.PublicKey(args.token_mint);
+            const tokenBalance = await (0, outsmart_1.getSPLTokenBalance)(connection, tokenMintPubkey, wallet.publicKey);
+            return ok({
+                wallet: address,
+                token_mint: args.token_mint,
+                balance: tokenBalance,
+            });
+        }
+        const connection = (0, outsmart_1.getConnection)();
+        const solBalance = await (0, outsmart_1.checkBalanceByAddress)(address, connection);
+        return ok({
+            wallet: address,
+            sol_balance: solBalance,
+        });
+    }
+    catch (e) {
+        return err(e.message);
+    }
+});
+// ---------------------------------------------------------------------------
+// Start server
+// ---------------------------------------------------------------------------
+async function main() {
+    // Register all 18 DEX adapters from the outsmart library
+    await (0, outsmart_1.registerAllAdapters)();
+    const transport = new stdio_js_1.StdioServerTransport();
+    await server.connect(transport);
+    // Log to stderr (stdout is reserved for MCP protocol messages)
+    console.error("outsmart-agent MCP server started (stdio transport)");
+}
+main().catch((e) => {
+    console.error("Fatal error starting MCP server:", e);
+    process.exit(1);
+});
+//# sourceMappingURL=server.js.map

package/dist/mcp/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "outsmart-agent",
+  "version": "1.0.0-alpha.1",
+  "description": "MCP server + AI skills for Solana trading — wraps the outsmart CLI library for AI agent use.",
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "outsmart-agent": "./dist/mcp/server.js"
+  },
+  "files": [
+    "dist/",
+    "skills/",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "npm run clean && npm run build:ts && npm run build:chmod",
+    "build:ts": "tsc -p tsconfig.build.json",
+    "build:chmod": "chmod +x dist/mcp/server.js || true",
+    "clean": "rm -rf dist/",
+    "dev": "ts-node src/mcp/server.ts",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "solana",
+    "mcp",
+    "ai-agent",
+    "trading",
+    "dex",
+    "outsmart",
+    "claude",
+    "skills"
+  ],
+  "author": "vincentso",
+  "license": "ISC",
+  "homepage": "https://github.com/outsmartchad/outsmart-agent",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/outsmartchad/outsmart-agent.git"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.1",
+    "@solana/spl-token": "^0.4.0",
+    "@solana/web3.js": "^1.95.0",
+    "outsmart": "^2.0.0-alpha.5",
+    "zod": "^3.25.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.5.4"
+  },
+  "overrides": {
+    "@solana/web3.js": "^1.95.0"
+  }
+}

package/skills/outsmart/SKILL.md

@@ -0,0 +1,306 @@
+---
+name: solana-trading
+description: Execute trades on Solana DEXes. Use when user says "buy token", "sell token", "swap", "add liquidity", "remove liquidity", "claim fees", "LP", "DEX", "pool", "Solana trade", "check price", "wallet balance", or mentions trading tokens on Solana.
+allowed-tools: mcp__outsmart-agent__solana_buy, mcp__outsmart-agent__solana_sell, mcp__outsmart-agent__solana_quote, mcp__outsmart-agent__solana_add_liquidity, mcp__outsmart-agent__solana_remove_liquidity, mcp__outsmart-agent__solana_claim_fees, mcp__outsmart-agent__solana_list_positions, mcp__outsmart-agent__solana_token_info, mcp__outsmart-agent__solana_list_dexes, mcp__outsmart-agent__solana_wallet_balance
+model: opus
+license: ISC
+metadata:
+  author: outsmartchad
+  version: '1.0.0'
+---
+
+# Solana Trading
+
+Execute trades, manage liquidity, and query market data across 18 Solana DEX protocols via the outsmart MCP server.
+
+## Quick Decision Guide
+
+| Goal | MCP Tool | Key Params |
+|------|----------|------------|
+| Buy tokens with SOL | `solana_buy` | `dex`, `pool` or `token`, `amount` |
+| Sell tokens for SOL | `solana_sell` | `dex`, `pool` or `token`, `percentage` |
+| Check on-chain price | `solana_quote` | `dex`, `pool` |
+| Add liquidity | `solana_add_liquidity` | `dex`, `pool`, `amount_sol` |
+| Remove liquidity | `solana_remove_liquidity` | `dex`, `pool`, `percentage` |
+| Claim LP fees | `solana_claim_fees` | `dex`, `pool` |
+| List LP positions | `solana_list_positions` | `dex`, `pool` |
+| Get token market data | `solana_token_info` | `token` |
+| List available DEXes | `solana_list_dexes` | |
+| Check wallet balance | `solana_wallet_balance` | |
+
+## DEX Selection Guide
+
+### When to use which DEX
+
+| Scenario | Recommended DEX | Why |
+|----------|----------------|-----|
+| Best price across all DEXes | `jupiter-ultra` | Aggregates routes across all Solana DEXes |
+| Specific pool on Raydium | `raydium-cpmm`, `raydium-clmm`, or `raydium-amm-v4` | Direct on-chain execution, no API dependency |
+| Meteora concentrated LP | `meteora-dlmm` | DLMM bins for precise price ranges |
+| Meteora standard LP | `meteora-damm-v2` | Full LP lifecycle (add/remove/claim) |
+| PumpFun tokens (bonding curve) | `pumpfun-amm` | Graduated PumpFun tokens on Raydium AMM |
+| Raydium Launchlab tokens | `raydium-launchlab` | Bonding curve tokens before migration |
+| Orca Whirlpools | `orca` | Concentrated liquidity on Orca |
+| Token is unknown / new | Use `solana_token_info` first | Check liquidity, age, and market data before trading |
+
+### DEX Categories
+
+**Swap Aggregators** (require `token`, NOT `pool`):
+- `jupiter-ultra` — Best for general trading, aggregates across all DEXes
+- `dflow` — Intent-based routing
+
+**On-Chain DEX Adapters** (require `pool`, token auto-detected):
+- `raydium-amm-v4` — Classic Raydium AMM
+- `raydium-cpmm` — Raydium constant product market maker
+- `raydium-clmm` — Raydium concentrated liquidity
+- `raydium-launchlab` — Raydium token launch bonding curves
+- `meteora-damm-v2` — Meteora Dynamic AMM v2 (full LP support)
+- `meteora-dlmm` — Meteora Discrete Liquidity Market Maker
+- `pumpfun-amm` — PumpFun graduated tokens
+- `orca` — Orca Whirlpools
+- And more (use `solana_list_dexes` to see all)
+
+## MCP Tool Reference
+
+### solana_buy
+
+Buy tokens with SOL on a specific DEX.
+
+**For aggregators** (jupiter-ultra, dflow):
+```json
+{
+  "dex": "jupiter-ultra",
+  "token": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
+  "amount": 0.1
+}
+```
+
+**For on-chain DEXes** (raydium, meteora, orca, etc.):
+```json
+{
+  "dex": "raydium-cpmm",
+  "pool": "POOL_ADDRESS",
+  "amount": 0.1
+}
+```
+
+| Param | Required | Description |
+|-------|----------|-------------|
+| `dex` | Yes | DEX adapter name |
+| `pool` | For on-chain DEXes | Pool address (base58) |
+| `token` | For aggregators | Token mint address (base58) |
+| `amount` | Yes | Amount of SOL to spend |
+| `slippage_bps` | No | Slippage tolerance in basis points (default: 300 = 3%) |
+| `tip_sol` | No | MEV tip in SOL for competitive execution |
+| `dry_run` | No | Simulate without sending (default: false) |
+
+### solana_sell
+
+Sell tokens for SOL.
+
+```json
+{
+  "dex": "raydium-cpmm",
+  "pool": "POOL_ADDRESS",
+  "percentage": 100
+}
+```
+
+| Param | Required | Description |
+|-------|----------|-------------|
+| `dex` | Yes | DEX adapter name |
+| `pool` | For on-chain DEXes | Pool address |
+| `token` | For aggregators | Token mint address |
+| `percentage` | Yes | Percentage of holdings to sell (0-100) |
+| `slippage_bps` | No | Slippage tolerance in basis points |
+| `dry_run` | No | Simulate without sending |
+
+### solana_quote
+
+Get on-chain price from a pool.
+
+```json
+{
+  "dex": "raydium-cpmm",
+  "pool": "POOL_ADDRESS"
+}
+```
+
+Returns: price, base/quote mints, pool address, timestamp.
+
+### solana_add_liquidity
+
+Add liquidity to a pool.
+
+```json
+{
+  "dex": "meteora-dlmm",
+  "pool": "POOL_ADDRESS",
+  "amount_sol": 0.1,
+  "strategy": "spot",
+  "bins": 50
+}
+```
+
+| Param | Required | Description |
+|-------|----------|-------------|
+| `dex` | Yes | DEX adapter name |
+| `pool` | Yes | Pool address |
+| `amount_sol` | No | SOL to deposit |
+| `amount_token` | No | Token to deposit |
+| `strategy` | No | Distribution: "spot", "curve", or "bid-ask" (DLMM only) |
+| `bins` | No | Number of bins (DLMM only, default: 50, max: 70) |
+
+### solana_remove_liquidity
+
+Remove liquidity from a pool.
+
+```json
+{
+  "dex": "meteora-dlmm",
+  "pool": "POOL_ADDRESS",
+  "percentage": 100
+}
+```
+
+| Param | Required | Description |
+|-------|----------|-------------|
+| `dex` | Yes | DEX adapter name |
+| `pool` | Yes | Pool address |
+| `percentage` | Yes | Percentage to remove (0-100) |
+| `position_address` | No | Specific position (if multiple) |
+
+### solana_claim_fees
+
+Claim accumulated swap fees from LP positions.
+
+```json
+{
+  "dex": "meteora-dlmm",
+  "pool": "POOL_ADDRESS"
+}
+```
+
+### solana_list_positions
+
+List user's LP positions in a pool.
+
+```json
+{
+  "dex": "meteora-dlmm",
+  "pool": "POOL_ADDRESS"
+}
+```
+
+Returns: position addresses, token amounts, fee balances, in-range status.
+
+### solana_token_info
+
+Get market data from DexScreener.
+
+```json
+{
+  "token": "TOKEN_MINT_ADDRESS"
+}
+```
+
+Returns: name, price, market cap, volume (5m/1h/6h/24h), buyers, liquidity, age, social links.
+
+### solana_list_dexes
+
+List all available DEX adapters and their capabilities.
+
+```json
+{}
+```
+
+Optional filter:
+```json
+{
+  "capability": "canAddLiquidity"
+}
+```
+
+### solana_wallet_balance
+
+Check SOL and token balances.
+
+```json
+{}
+```
+
+For a specific token:
+```json
+{
+  "token_mint": "TOKEN_MINT_ADDRESS"
+}
+```
+
+## Safety Rules
+
+1. **Always check liquidity first.** Before buying a token, use `solana_token_info` to check liquidity depth. Low liquidity means high slippage and potential rug risk.
+
+2. **Use dry_run for large trades.** Set `dry_run: true` to simulate the trade and check for errors before committing SOL.
+
+3. **Start with small amounts.** When trading an unfamiliar token, start with a small test buy (0.01 SOL) to verify the pool works correctly.
+
+4. **Check token age.** Tokens less than 1 hour old are extremely high risk. Use `solana_token_info` to check `pairAge`.
+
+5. **Prefer aggregators for best price.** Use `jupiter-ultra` for the best price across all DEXes. Only use on-chain adapters when you need a specific pool.
+
+6. **Monitor LP positions.** After adding liquidity, regularly check positions with `solana_list_positions` and claim fees with `solana_claim_fees`.
+
+7. **Never trade more than you can afford to lose.** Solana memecoins are extremely volatile. Most go to zero.
+
+8. **Check volume and buyers.** Healthy tokens have consistent buy/sell activity. If `buyers5m` is 0 but `volume5m` is high, it may be wash trading.
+
+## Common Workflows
+
+### Buy a Token
+
+With an aggregator (simplest — no pool address needed):
+```
+1. solana_token_info(token) → check liquidity, age, volume
+2. solana_buy(dex="jupiter-ultra", token, amount, dry_run=true) → simulate
+3. solana_buy(dex="jupiter-ultra", token, amount) → execute
+```
+
+With an on-chain DEX (need pool address from DexScreener or other source):
+```
+1. solana_token_info(token) → check liquidity, get pool address
+2. solana_buy(dex, pool, amount, dry_run=true) → simulate
+3. solana_buy(dex, pool, amount) → execute
+```
+
+### Provide Liquidity
+
+```
+1. solana_quote(dex, pool) → check current price
+2. solana_add_liquidity(dex, pool, amount_sol, strategy="spot") → add LP
+3. solana_list_positions(dex, pool) → verify position
+```
+
+### Exit LP Position
+
+```
+1. solana_list_positions(dex, pool) → check positions
+2. solana_claim_fees(dex, pool) → collect fees first
+3. solana_remove_liquidity(dex, pool, percentage=100) → withdraw
+```
+
+### Sell Everything
+
+```
+1. solana_sell(dex, pool, percentage=100) → sell all holdings
+```
+
+## Environment Variables
+
+The MCP server requires these env vars to be set:
+
+| Variable | Required | Description |
+|----------|----------|-------------|
+| `WALLET_PRIVATE_KEY` | Yes | Base58-encoded Solana private key |
+| `RPC_URL` | Yes | Solana RPC endpoint (Helius, Triton, etc.) |
+| `JUPITER_API_KEY` | No | Required for jupiter-ultra adapter |
+| `DFLOW_API_KEY` | No | Required for dflow adapter |