@potswap_io/mcp 0.3.0 → 0.4.0

package/README.md

@@ -78,6 +78,7 @@ Use a dedicated agent wallet with only the funds you want the agent to control.
 | `get_positions {wallet?}` | Holdings with USD value, average cost, unrealised and realised PnL (from swap history) |
 | `get_points {wallet?}` | Season 1 points, POT allocated / claimable, next unlock |
 | `get_leaderboard` | Top wallets by fee paid |
+| `get_launch_status` | Launch-pool meter (SOL / 500 target, from chain), season and day, fee split, unclaimed reward balances and the public claim ladder |
 | `get_price_history {mint, timeframe, limit}` | OHLCV candles from the token's top pool (`1m`…`1d`) |
 
 ### Wallet and operations (0.3.0)
@@ -119,7 +120,11 @@ State lives in `~/.potswap/strategies.json` (override with `POTSWAP_STATE_DIR`);
 
 ## Fees and rewards
 
-Each swap carries Potswap's 2.5% integrator fee via Jupiter's referral program; Jupiter keeps 20% of it, and 50% of what remains buys and burns POT each epoch. The fee basis is credited to the trading wallet as Season 1 points, split daily: 666,666 POT per epoch, by `fee^1.1`, capped at 10% per wallet. Points become POT tokens after the token launch; unlock 7 days after each epoch. Details: https://www.potswap.io
+Each swap carries Potswap's 2.5% integrator fee via Jupiter's referral program (1% above $1,000; stakers get −1%); Jupiter keeps 20%.
+
+**Season 0 (now, before the token):** 60% of the net fee fills the **launch pool**; when it reaches 500 SOL the POT token launches on its own liquidity pool. 20% of your net fee is set aside as your **reward balance** (in SOL): after launch it buys POT for you, when you say so (`claim now` at market, or a limit claim at your price). 20% runs the project. Every day you trade in Season 0 earns a slice of the **250M POT airdrop** (25% of supply), replayed day by day after launch: fee basis `fee^1.1`, capped at 10% of the day per wallet, round trips within 10 minutes count 25%.
+
+**Seasons 1+ (30 days each):** `20M × 0.85^(n−1)` POT per season shared daily by fee basis; 30% of the net fee buys and burns POT, 20% keeps feeding reward balances, 50% team and operations. Levels (Larva → Bee → Queen, up to ×1.25) persist across seasons. `get_points` shows your balance, level and season; `get_launch_status` shows the meter. Only protocol fees enter the pool: nothing can be deposited. Details: https://www.potswap.io
 
 ## Development
 

package/dist/agentTools.js

@@ -154,6 +154,26 @@ export function registerAgentTools(server, deps) {
     const lst = (p) => (p === 'jito' ? JITOSOL_MINT : MSOL_MINT);
     stakeTool('stake_sol', 'Liquid-stake SOL', 'Swaps SOL into jitoSOL (Jito) or mSOL (Marinade) at the best route. Normal fee and points apply. Requires confirm=true.', () => SOL_MINT, lst);
     stakeTool('unstake_sol', 'Unstake liquid SOL', 'Swaps jitoSOL or mSOL back into SOL at the best route. Normal fee and points apply. Requires confirm=true.', lst, () => SOL_MINT);
+    // PRD P12.1 / P12.6a — launch meter, season, splits and the public claim pressure.
+    server.registerTool('get_launch_status', {
+        title: 'POT launch status',
+        description: 'Launch-pool meter (SOL collected / target, read from chain), current season and day, fee split in force, total unclaimed reward balances and the pending claim ladder. Only protocol fees fill the pool; nothing can be deposited.',
+        inputSchema: {},
+    }, async () => {
+        try {
+            const pool = await api.launchPool();
+            const stats = await api.stats().catch(() => ({}));
+            const season = pool.season;
+            const data = { ...pool, unclaimedSol: stats.unclaimedSol ?? null, claimLadder: stats.claimLadder ?? [], potDistributedMicro: stats.potDistributedMicro ?? null };
+            const line = pool.launch && Date.parse(String(pool.launch)) <= Date.now()
+                ? `POT launched ${pool.launch}. Season ${season?.n}${season?.dayIndex ? ` day ${season.dayIndex}/30` : ''}${season?.end ? `, ends ${season.end}` : ''}.`
+                : `Launch pool: ${pool.balanceSol} / ${pool.targetSol} SOL (${Math.round(Number(pool.pct))}%)${pool.enabled ? '' : ' — pool address not published yet'}. Season 0: 60% of every net fee fills the pool; 20% builds your reward balance.`;
+            return ok(data, `${line}${data.unclaimedSol !== null && data.unclaimedSol !== undefined ? ` Unclaimed reward balances: ${data.unclaimedSol} SOL.` : ''}`);
+        }
+        catch (e) {
+            return fail(e instanceof Error ? e.message : String(e));
+        }
+    });
     // Upgraded positions with PnL (P13.7): replaces the basic tool registered by the core server.
     server.registerTool('get_positions', {
         title: 'Positions with PnL',

package/dist/api.d.ts

@@ -37,6 +37,8 @@ export declare class PotswapApi {
     list(kind: string): Promise<TerminalToken[]>;
     terminalToken(mint: string): Promise<TerminalToken>;
     points(wallet: string): Promise<Record<string, unknown>>;
+    launchPool(): Promise<Record<string, unknown>>;
+    stats(): Promise<Record<string, unknown>>;
     history(wallet: string, limit?: number): Promise<import("./history.js").HeliusTx[]>;
     ohlcv(mint: string, tf: string, limit?: number): Promise<{
         mint: string;

package/dist/api.js

@@ -87,6 +87,8 @@ export class PotswapApi {
     list(kind) { return this.req(`/api/terminal/list/${kind}`); }
     terminalToken(mint) { return this.req(`/api/terminal/token/${mint}`); }
     points(wallet) { return this.req(`/api/points/${wallet}`); }
+    launchPool() { return this.req('/api/launch-pool'); }
+    stats() { return this.req('/api/stats'); }
     history(wallet, limit = 25) { return this.req(`/api/history/${wallet}?limit=${limit}`); }
     ohlcv(mint, tf, limit = 100) { return this.req(`/api/terminal/ohlcv/${mint}?tf=${tf}&limit=${limit}`); }
     leaderboard() { return this.req('/api/leaderboard'); }

package/dist/server.d.ts

@@ -7,7 +7,7 @@ import { type TxRpc } from './agentTools.js';
 import type { Rpc } from './transfer.js';
 import type { StrategyStore } from './strategies/store.js';
 import type { Scheduler } from './strategies/scheduler.js';
-export declare const VERSION = "0.3.0";
+export declare const VERSION = "0.4.0";
 export interface ServerDeps {
     config?: Config;
     signer?: Signer | null;

package/dist/server.js

@@ -10,7 +10,7 @@ import { loadSigner } from './wallet.js';
 import { riskBadges, riskLevel } from './shared/risk.js';
 import { registerStrategyTools } from './strategies/tools.js';
 import { registerAgentTools } from './agentTools.js';
-export const VERSION = '0.3.0';
+export const VERSION = '0.4.0';
 const ok = (data, summary) => ({
     content: [{ type: 'text', text: redact(summary ?? JSON.stringify(data, null, 2)) }], structuredContent: redactValue(data),
 });
@@ -117,7 +117,7 @@ export function createServer(deps = {}) {
     });
     server.registerTool('get_points', {
         title: 'POT points',
-        description: "Season 1 points for a wallet: this epoch, all-time, POT allocated and claimable, next unlock. Defaults to the agent wallet.",
+        description: "Points and rewards for a wallet: this epoch, all-time, POT allocated and claimable, next unlock, reward balance (SOL, buys POT after launch), level and season. Defaults to the agent wallet.",
         inputSchema: { wallet: z.string().regex(/^[1-9A-HJ-NP-Za-km-z]{32,44}$/).optional() },
     }, async ({ wallet }) => {
         const w = walletOr(wallet);

package/package.json

@@ -1,59 +1,59 @@
-{
-  "name": "@potswap_io/mcp",
-  "version": "0.3.0",
-  "description": "Potswap MCP server: best-route Solana swaps, DCA / rebalance / take-profit strategies for AI agents, non-custodial, earns POT.",
-  "license": "MIT",
-  "type": "module",
-  "bin": {
-    "potswap-mcp": "dist/index.js"
-  },
-  "main": "dist/server.js",
-  "types": "dist/server.d.ts",
-  "files": [
-    "dist",
-    "README.md",
-    "LICENSE"
-  ],
-  "engines": {
-    "node": ">=20"
-  },
-  "scripts": {
-    "build": "tsc -p tsconfig.json",
-    "dev": "tsx src/index.ts",
-    "test": "vitest run",
-    "typecheck": "tsc -p tsconfig.json --noEmit",
-    "sync-shared": "node scripts/sync-shared.mjs",
-    "prepublishOnly": "npm run sync-shared && npm run build"
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/potswap-io/mcp.git"
-  },
-  "homepage": "https://www.potswap.io",
-  "keywords": [
-    "mcp",
-    "solana",
-    "swap",
-    "jupiter",
-    "ai-agent",
-    "potswap",
-    "model-context-protocol"
-  ],
-  "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.32.2",
-    "@solana/spl-token": "^0.4.15",
-    "@solana/web3.js": "^1.99.0",
-    "bs58": "^6.0.0",
-    "zod": "^4.6.7"
-  },
-  "devDependencies": {
-    "@types/node": "^26.6.5",
-    "tsx": "^4.23.15",
-    "typescript": "^7.0.2",
-    "vite": "^8.3.5",
-    "vitest": "^5.0.5"
-  },
-  "bugs": {
-    "url": "https://github.com/potswap-io/mcp/issues"
-  }
-}
+{
+  "name": "@potswap_io/mcp",
+  "version": "0.4.0",
+  "description": "Potswap MCP server: best-route Solana swaps, DCA / rebalance / take-profit strategies for AI agents, non-custodial, earns POT.",
+  "license": "MIT",
+  "type": "module",
+  "bin": {
+    "potswap-mcp": "dist/index.js"
+  },
+  "main": "dist/server.js",
+  "types": "dist/server.d.ts",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "dev": "tsx src/index.ts",
+    "test": "vitest run",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "sync-shared": "node scripts/sync-shared.mjs",
+    "prepublishOnly": "npm run sync-shared && npm run build"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/potswap-io/mcp.git"
+  },
+  "homepage": "https://www.potswap.io",
+  "keywords": [
+    "mcp",
+    "solana",
+    "swap",
+    "jupiter",
+    "ai-agent",
+    "potswap",
+    "model-context-protocol"
+  ],
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.32.2",
+    "@solana/spl-token": "^0.4.15",
+    "@solana/web3.js": "^1.99.0",
+    "bs58": "^6.0.0",
+    "zod": "^4.6.7"
+  },
+  "devDependencies": {
+    "@types/node": "^26.6.5",
+    "tsx": "^4.23.15",
+    "typescript": "^7.0.2",
+    "vite": "^8.3.5",
+    "vitest": "^5.0.5"
+  },
+  "bugs": {
+    "url": "https://github.com/potswap-io/mcp/issues"
+  }
+}