swap_quote
Calculate token exchange details including price impact, fees, and minimum output amount with slippage for informed trading decisions.
Instructions
Get swap quote for token exchange including price impact, fees, and minimum output amount with slippage.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| poolAddress | Yes | Pool address for the swap | |
| fromMint | Yes | Source token mint address | |
| toMint | Yes | Destination token mint address | |
| amount | Yes | Amount to swap (in token decimals) | |
| slippage | No | Slippage tolerance (0-100, default 0.5) |
Implementation Reference
- src/tools/swap-quote.js:5-56 (handler)The main handler function for the 'swap_quote' tool. Validates input parameters, calls poolService.getSwapQuote to retrieve the quote, formats it as a markdown text response, and returns it in the expected MCP format.async function swapQuoteTool(args, poolService) { const { poolAddress, fromMint, toMint, amount, slippage = 0.5 } = args; if (!poolAddress || !fromMint || !toMint || !amount) { throw new Error("poolAddress, fromMint, toMint, and amount are required"); } if (amount <= 0) { throw new Error("Amount must be greater than 0"); } if (slippage < 0 || slippage > 100) { throw new Error("Slippage must be between 0 and 100"); } try { const quote = await poolService.getSwapQuote( poolAddress, fromMint, toMint, amount, slippage ); const quoteText = `**Swap Quote**\n\n` + `**Input:**\n` + `- Pool: ${poolAddress}\n` + `- From: ${fromMint.slice(0, 8)}...\n` + `- To: ${toMint.slice(0, 8)}...\n` + `- Amount: ${amount}\n\n` + `**Output:**\n` + `- Expected Output: ${quote.outputAmount}\n` + `- Minimum Output (with slippage): ${quote.minimumOutputAmount}\n` + `- Price Impact: ${quote.priceImpact.toFixed(4)}%\n` + `- Fee: ${quote.fee}\n` + `- Slippage Tolerance: ${quote.slippage}%\n\n` + `**Rate:** 1 token = ${(quote.outputAmount / amount).toFixed(6)} tokens`; return { content: [ { type: "text", text: quoteText, }, ], }; } catch (error) { throw new Error(`Failed to get swap quote: ${error.message}`); } } module.exports = { swapQuoteTool };
- src/index.js:115-146 (schema)The input schema and description for the 'swap_quote' tool, registered in the ListTools response.{ name: "swap_quote", description: "Get swap quote for token exchange including price impact, fees, and minimum output amount with slippage.", inputSchema: { type: "object", properties: { poolAddress: { type: "string", description: "Pool address for the swap", }, fromMint: { type: "string", description: "Source token mint address", }, toMint: { type: "string", description: "Destination token mint address", }, amount: { type: "number", description: "Amount to swap (in token decimals)", }, slippage: { type: "number", description: "Slippage tolerance (0-100, default 0.5)", default: 0.5, }, }, required: ["poolAddress", "fromMint", "toMint", "amount"], }, },
- src/index.js:168-170 (registration)Registration of the 'swap_quote' tool in the CallToolRequestSchema handler switch statement, dispatching calls to the swapQuoteTool function.case "swap_quote": return await swapQuoteTool(args, this.poolService);
- src/services/pool-service.js:37-48 (helper)Helper method in SarosPoolService that computes the swap quote (mock implementation used by the tool handler).async getSwapQuote(poolAddress, fromMint, toMint, amount, slippage = 0.5) { const rate = 1.5; const outputAmount = amount * rate; return { inputAmount: amount, outputAmount, minimumOutputAmount: outputAmount * (1 - slippage / 100), priceImpact: 0.15, fee: amount * 0.0025, slippage, }; }