@potswap_io/mcp 0.3.0 → 0.5.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,16 @@ 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. Full documentation: https://potswap-docs.pages.dev (every tool, configuration, limits, economy; also as /llms.txt for agents).
+
+## Also available
+
+- **`@potswap_io/sdk`** — the same engine as a typed library for bots, scripts and other agent frameworks. The MCP server is built on it.
+- **`@potswap_io/cli`** — the `potswap` command: `npx -y @potswap_io/cli quote SOL USDC 0.1`; swaps, transfers, wallet, points, launch meter, strategy management and `potswap daemon`.
 
 ## Development
 

package/dist/agentTools.d.ts

@@ -1,8 +1,8 @@
 import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { Connection } from '@solana/web3.js';
-import { type Config } from './config.js';
-import { type TradeContext } from './trade.js';
-import { type Rpc } from './transfer.js';
+import { type Config } from '@potswap_io/sdk';
+import { type TradeContext } from '@potswap_io/sdk';
+import { type Rpc } from '@potswap_io/sdk';
 /** Transaction-level RPC reads; injectable for tests. */
 export interface TxRpc {
     getSignatureStatus(sig: string): Promise<{

package/dist/agentTools.js

@@ -1,12 +1,12 @@
 import { Connection } from '@solana/web3.js';
 import { z } from 'zod';
-import { JITOSOL_MINT, MSOL_MINT, NO_WALLET, SOL_MINT } from './config.js';
-import { redact, redactValue } from './redact.js';
-import { createWallet } from './wallet.js';
-import { executeSwap } from './trade.js';
-import { executeTransfer, rpcFromConnection } from './transfer.js';
-import { mapSignatureStatus, normalizeHistory } from './history.js';
-import { computePositions } from './pnl.js';
+import { JITOSOL_MINT, MSOL_MINT, NO_WALLET, SOL_MINT } from '@potswap_io/sdk';
+import { redact, redactValue } from '@potswap_io/sdk';
+import { createWallet } from '@potswap_io/sdk';
+import { executeSwap } from '@potswap_io/sdk';
+import { executeTransfer, rpcFromConnection } from '@potswap_io/sdk';
+import { mapSignatureStatus, normalizeHistory } from '@potswap_io/sdk';
+import { computePositions } from '@potswap_io/sdk';
 const ok = (data, summary) => ({ content: [{ type: 'text', text: redact(summary ?? JSON.stringify(data, null, 2)) }], structuredContent: redactValue(data) });
 const fail = (message, extra = {}) => ({ content: [{ type: 'text', text: redact(message) }], structuredContent: redactValue({ error: message, ...extra }), isError: true });
 const MINT = z.string().regex(/^[1-9A-HJ-NP-Za-km-z]{32,44}$/);
@@ -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/index.js

@@ -2,9 +2,9 @@
 // Potswap MCP server over stdio, or `--daemon` to run strategies headlessly (PRD P11.11).
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
 import { createServer, VERSION } from './server.js';
-import { loadConfig } from './config.js';
-import { log } from './redact.js';
-import { createRuntime } from './runtime.js';
+import { loadConfig } from '@potswap_io/sdk';
+import { log } from '@potswap_io/sdk';
+import { createRuntime } from '@potswap_io/sdk';
 const config = loadConfig();
 const daemon = process.argv.includes('--daemon');
 const rt = createRuntime(config);

package/dist/server.d.ts

@@ -1,13 +1,13 @@
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-import { type FetchFn } from './api.js';
-import { SOL_MINT, USDC_MINT, type Config } from './config.js';
-import { type BalancesFn } from './trade.js';
-import { type Signer } from './wallet.js';
+import { type FetchFn } from '@potswap_io/sdk';
+import { SOL_MINT, USDC_MINT, type Config } from '@potswap_io/sdk';
+import { type BalancesFn } from '@potswap_io/sdk';
+import { type Signer } from '@potswap_io/sdk';
 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";
+import type { Rpc } from '@potswap_io/sdk';
+import type { StrategyStore } from '@potswap_io/sdk';
+import type { Scheduler } from '@potswap_io/sdk';
+export declare const VERSION = "0.5.0";
 export interface ServerDeps {
     config?: Config;
     signer?: Signer | null;

package/dist/server.js

@@ -2,15 +2,15 @@
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { Connection, PublicKey } from '@solana/web3.js';
 import { z } from 'zod';
-import { PotswapApi, ApiError } from './api.js';
-import { loadConfig, NO_WALLET, SOL_MINT, USDC_MINT } from './config.js';
-import { buildQuote, executeSwap } from './trade.js';
-import { redact, redactValue } from './redact.js';
-import { loadSigner } from './wallet.js';
-import { riskBadges, riskLevel } from './shared/risk.js';
+import { PotswapApi, ApiError } from '@potswap_io/sdk';
+import { loadConfig, NO_WALLET, SOL_MINT, USDC_MINT } from '@potswap_io/sdk';
+import { buildQuote, executeSwap } from '@potswap_io/sdk';
+import { redact, redactValue } from '@potswap_io/sdk';
+import { loadSigner } from '@potswap_io/sdk';
+import { riskBadges, riskLevel } from '@potswap_io/sdk';
 import { registerStrategyTools } from './strategies/tools.js';
 import { registerAgentTools } from './agentTools.js';
-export const VERSION = '0.3.0';
+export const VERSION = '0.5.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/dist/strategies/tools.d.ts

@@ -1,7 +1,7 @@
 import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-import type { TradeContext } from '../trade.js';
-import { type StrategyStore } from './store.js';
-import type { Scheduler } from './scheduler.js';
+import type { TradeContext } from '@potswap_io/sdk';
+import { type StrategyStore } from '@potswap_io/sdk';
+import type { Scheduler } from '@potswap_io/sdk';
 export interface StrategyDeps {
     trade: TradeContext;
     store?: StrategyStore;

package/dist/strategies/tools.js

@@ -1,8 +1,8 @@
 import { z } from 'zod';
-import { NO_WALLET } from '../config.js';
-import { redact, redactValue } from '../redact.js';
-import { newId, SOL_MINT, nextRunAfter } from './engine.js';
-import { findStrategy, runsOf } from './store.js';
+import { NO_WALLET } from '@potswap_io/sdk';
+import { redact, redactValue } from '@potswap_io/sdk';
+import { newId, SOL_MINT, nextRunAfter } from '@potswap_io/sdk';
+import { findStrategy, runsOf } from '@potswap_io/sdk';
 const MINT = z.string().regex(/^[1-9A-HJ-NP-Za-km-z]{32,44}$/);
 const MAX_STRATEGIES = Number(process.env.POTSWAP_MAX_STRATEGIES) || 10;
 const ok = (data, summary) => ({ content: [{ type: 'text', text: redact(summary ?? JSON.stringify(data, null, 2)) }], structuredContent: redactValue(data) });

package/package.json

@@ -1,7 +1,7 @@
 {
   "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.",
+  "version": "0.5.0",
+  "description": "Potswap MCP server: best-route Solana swaps, wallet, transfers, staking, DCA / rebalance / take-profit / limit strategies and POT rewards for AI agents. Non-custodial; built on @potswap_io/sdk.",
   "license": "MIT",
   "type": "module",
   "bin": {
@@ -22,8 +22,7 @@
     "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"
+    "prepublishOnly": "npm run build"
   },
   "repository": {
     "type": "git",
@@ -41,9 +40,8 @@
   ],
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.32.2",
-    "@solana/spl-token": "^0.4.15",
+    "@potswap_io/sdk": "^0.1.0",
     "@solana/web3.js": "^1.99.0",
-    "bs58": "^6.0.0",
     "zod": "^4.6.7"
   },
   "devDependencies": {