@potswap_io/mcp 0.6.0 → 0.7.0

package/README.md

@@ -73,7 +73,8 @@ Use a dedicated agent wallet with only the funds you want the agent to control.
 | `get_token {mint}` | Price, mcap, liquidity, holders, audit data, **risk badges** (`riskLevel` 0 safe → 3 danger) |
 | `get_trending {kind}` | `new`, `trending`, `top`, `graduating` lists |
 | `get_quote {inputMint, outputMint, amount}` | Best route, fee, impact, router. `amount` is in UI units (1 = 1 SOL) |
-| `swap {…, confirm: true}` | Executes at the best route and returns the signature, amounts, fee and POT points |
+| `swap {…, confirm: true, route?, opId?}` | Executes at the best route and returns the signature, amounts, fee and POT points. `route: direct` swaps on a Raydium CPMM pool built and validated locally (same fee); `opId` makes retries safe |
+| `get_operation {id?}` | State of an idempotent swap (pending / sent / ok / failed / unknown) |
 | `get_balances {wallet?}` | SOL + SPL balances with USD |
 | `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 |

package/dist/server.d.ts

@@ -5,9 +5,10 @@ import { type BalancesFn } from '@potswap_io/sdk';
 import { type Signer } from '@potswap_io/sdk';
 import { type TxRpc } from './agentTools.js';
 import type { Rpc } from '@potswap_io/sdk';
+import { type OpsStore } from '@potswap_io/sdk';
 import type { StrategyStore } from '@potswap_io/sdk';
 import type { Scheduler } from '@potswap_io/sdk';
-export declare const VERSION = "0.6.0";
+export declare const VERSION = "0.7.0";
 export interface ServerDeps {
     config?: Config;
     signer?: Signer | null;
@@ -22,6 +23,8 @@ export interface ServerDeps {
     txRpc?: TxRpc;
     /** Current slot for observation anchoring; injectable for tests (P15). */
     getSlot?: () => Promise<number>;
+    /** Idempotent operation records (P14.3); defaults to a file store in the state dir. */
+    ops?: OpsStore;
 }
 export declare function createServer(deps?: ServerDeps): McpServer;
 export { SOL_MINT, USDC_MINT };

package/dist/server.js

@@ -11,7 +11,8 @@ import { riskBadges, riskLevel } from '@potswap_io/sdk';
 import { registerStrategyTools } from './strategies/tools.js';
 import { registerAgentTools } from './agentTools.js';
 import { registerObservationTools } from './observationTools.js';
-export const VERSION = '0.6.0';
+import { FileOpsStore, rpcFromConnection } from '@potswap_io/sdk';
+export const VERSION = '0.7.0';
 const ok = (data, summary) => ({
     content: [{ type: 'text', text: redact(summary ?? JSON.stringify(data, null, 2)) }], structuredContent: redactValue(data),
 });
@@ -23,7 +24,7 @@ export function createServer(deps = {}) {
     const signer = deps.signer !== undefined ? deps.signer : loadSigner({ privateKey: config.privateKey, keypairPath: config.keypairPath, stateDir: config.stateDir });
     const api = new PotswapApi(config.apiBase, deps.fetchFn);
     const readBalances = deps.balances ?? rpcBalances(config.rpcUrl);
-    const trade = { api, config, signer, balances: readBalances };
+    const trade = { api, config, signer, balances: readBalances, rpc: deps.rpc ?? rpcFromConnection(new Connection(config.rpcUrl, 'confirmed')), ops: deps.ops ?? new FileOpsStore(config.stateDir) };
     const server = new McpServer({ name: 'potswap', version: VERSION });
     const walletOr = (w) => w ?? signer?.publicKey ?? null;
     server.registerTool('search_tokens', {
@@ -70,12 +71,12 @@ export function createServer(deps = {}) {
     });
     server.registerTool('get_quote', {
         title: 'Get a swap quote',
-        description: 'Best route across Metis, JupiterZ, DFlow and OKX. Amount is in UI units of the input token (1 = 1 SOL). Includes the Potswap fee (returned to the wallet as POT points).',
+        description: 'Best route across Metis, JupiterZ, DFlow and OKX, plus `direct` when a Raydium CPMM pool exists (same Potswap fee, compared net). Amount is in UI units of the input token (1 = 1 SOL). Includes the Potswap fee (returned to the wallet as POT points).',
         inputSchema: quoteShape,
     }, async (a) => {
         try {
-            const q = await buildQuote(api, a);
-            return ok({ ...q }, `${a.amount} ${q.inputSymbol} → ${q.outAmount} ${q.outputSymbol} via ${q.router} (fee ${q.feeLabel ?? `${q.feeBps} bps`}, impact ${q.priceImpactPct}%)`);
+            const q = await buildQuote(api, a, { direct: trade.rpc });
+            return ok({ ...q }, `${a.amount} ${q.inputSymbol} → ${q.outAmount} ${q.outputSymbol} via ${q.router} (fee ${q.feeLabel ?? `${q.feeBps} bps`}, impact ${q.priceImpactPct}%)${q.direct ? `\nDirect Raydium CPMM: ${q.direct.outAmount} ${q.outputSymbol} (${q.direct.savedVsAggregatorPct >= 0 ? '+' : ''}${q.direct.savedVsAggregatorPct.toFixed(2)}% vs aggregator, pool fee ${q.direct.poolTradeFeeBps} bps)` : ''}`);
         }
         catch (e) {
             return fail(msg(e));
@@ -83,19 +84,33 @@ export function createServer(deps = {}) {
     });
     server.registerTool('swap', {
         title: 'Swap tokens (signs with the agent wallet)',
-        description: 'Executes a swap at the best route. Requires confirm=true; otherwise returns the quote only. Protected by POTSWAP_MAX_TRADE_SOL and POTSWAP_MAX_SLIPPAGE_BPS. Every error states whether funds were debited.',
-        inputSchema: { ...quoteShape, confirm: z.boolean().default(false), maxSlippageBps: z.number().int().min(1).max(5000).optional() },
+        description: 'Executes a swap at the best route. Requires confirm=true; otherwise returns the quote only. Protected by POTSWAP_MAX_TRADE_SOL, POTSWAP_MAX_SLIPPAGE_BPS and the transaction validator. route=direct uses a Raydium CPMM pool built locally (same fee); route=auto picks the better net output. opId makes the call safe to retry (a repeat returns the stored result). Every error states whether funds were debited.',
+        inputSchema: { ...quoteShape, confirm: z.boolean().default(false), maxSlippageBps: z.number().int().min(1).max(5000).optional(), route: z.enum(['jupiter', 'direct', 'auto']).default('jupiter'), opId: z.string().min(4).max(64).optional() },
     }, async (a) => {
-        const out = await executeSwap(trade, { inputMint: a.inputMint, outputMint: a.outputMint, amount: a.amount, slippageBps: a.slippageBps ?? a.maxSlippageBps, confirm: a.confirm });
+        const out = await executeSwap(trade, { inputMint: a.inputMint, outputMint: a.outputMint, amount: a.amount, slippageBps: a.slippageBps ?? a.maxSlippageBps, confirm: a.confirm, route: a.route, opId: a.opId });
         switch (out.kind) {
             case 'no-wallet': return fail(out.message);
             case 'refused': return fail(out.message, { quote: out.quote });
             case 'quote-only': return ok({ confirmRequired: true, quote: out.quote }, `Quote only (confirm=true to execute): ${a.amount} ${out.quote.inputSymbol} → ${out.quote.outAmount} ${out.quote.outputSymbol} via ${out.quote.router}`);
             case 'dry-run': return ok({ dryRun: true, quote: out.quote }, `DRY RUN, nothing signed: ${a.amount} ${out.quote.inputSymbol} → ${out.quote.outAmount} ${out.quote.outputSymbol}`);
             case 'failed': return fail(out.message, { signature: out.signature, explorerUrl: out.explorerUrl, quote: out.quote });
-            case 'ok': return ok({ ...out.result }, `Swapped ${a.amount} ${out.result.inputSymbol} → ${out.result.outAmount} ${out.result.outputSymbol} via ${out.result.router}. ${out.result.explorerUrl}`);
+            case 'ok': return ok({ ...out.result }, `${out.result.replayed ? 'Already done (replayed): ' : 'Swapped '}${a.amount} ${out.result.inputSymbol} → ${out.result.outAmount} ${out.result.outputSymbol} via ${out.result.router}. ${out.result.explorerUrl}`);
         }
     });
+    server.registerTool('get_operation', {
+        title: 'Operation record',
+        description: 'State of an idempotent swap by opId: pending, sent, ok, failed or unknown, with the signature and result when known. Lists recent operations without an id.',
+        inputSchema: { id: z.string().min(4).max(64).optional(), limit: z.number().int().min(1).max(100).default(20) },
+    }, async ({ id, limit }) => {
+        if (!trade.ops)
+            return fail('No operation store configured.');
+        if (id) {
+            const r = trade.ops.get(id);
+            return r ? ok({ ...r }, `${r.id}: ${r.state}${r.signature ? ` · ${r.signature}` : ''}${r.error ? ` · ${r.error}` : ''}`) : fail(`No operation ${id}.`);
+        }
+        const rows = trade.ops.list(limit);
+        return ok({ operations: rows }, rows.map((r) => `${r.updatedAt} ${r.id} ${r.state}${r.signature ? ` ${r.signature.slice(0, 8)}…` : ''}`).join('\n') || 'No operations yet.');
+    });
     server.registerTool('get_balances', {
         title: 'Wallet balances',
         description: 'SOL and SPL token balances with USD values. Defaults to the agent wallet.',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@potswap_io/mcp",
-  "version": "0.6.0",
+  "version": "0.7.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",
@@ -40,7 +40,7 @@
   ],
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.32.2",
-    "@potswap_io/sdk": "^0.2.0",
+    "@potswap_io/sdk": "^0.3.0",
     "@solana/web3.js": "^1.99.0",
     "zod": "^4.6.7"
   },