@parabolicfamily/mcp 0.2.0 → 0.2.1

package/src/parabolic.ts

@@ -9,7 +9,7 @@ import { DEPLOYMENTS, NATIVE_QUOTE, chainName, explorerUrl, siteBase, type Confi
 import { deployedAt } from "./deployed.js";
 import { applySlippage, graduationMarketCap, graduationSplit, marketCap, passesPriceBound, poolIdOf, priceImpact, quoteBuy, quoteSell, reservedTokensFor, spotPrice, toNumber, type CurveTerms } from "./curve.js";
 import { docsText } from "./docs.js";
-import { addrOf, amount, big, bool, endpointHost, num, parseAddress, parseAmount, safeMessage, str } from "./format.js";
+import { addrOf, amount, big, bool, endpointHost, num, parseAddress, parseAmount, safeMessage, shortAddr, str } from "./format.js";
 import { quoteBlock, quoteUnitOf, defaultQuoteOf, type QuoteBlock, type QuoteUnit } from "./quote-unit.js";
 import { RestApi, type PairFilter } from "./restapi.js";
 import { RoutedTrades } from "./routed.js";
@@ -300,7 +300,7 @@ export class Parabolic {
       const unit = quoteUnitOf(gas.symbol, chainId);
       return { pairToken: NATIVE_QUOTE, symbol: gas.symbol, decimals: gas.decimals, unit, isNative: true, block: quoteBlock(unit, NATIVE_QUOTE, gas.decimals, true) };
     }
-    const short = `${pairToken.slice(0, 6)}…${pairToken.slice(-4)}`;
+    const short = shortAddr(pairToken);
     const raw = await this.read(pairToken, tokenAbi, "decimals").catch(() => undefined);
     const decimals = num(raw);
     if (raw === undefined || !Number.isInteger(decimals) || decimals < 0 || decimals > 36) {
@@ -584,7 +584,7 @@ export class Parabolic {
   private async chainDetail(l: Launch) {
     const [tk, c, hook, quote] = await Promise.all([
       this.readMany(l.token, tokenAbi, ["name", "symbol", "totalSupply", "getTokenInfo"]),
-      this.readMany(l.curve, curveAbi, ["getReserves", "realQuoteReserve", "graduated", "readyToGraduate", "launchedAt", "currentSnipeTaxBps", "snipeTaxStartBps", "snipeTaxSeconds", "feeBps", "creatorTaxBps", "phantomQuote", "reservedTokens", "sellableTokens", "protocolFeeShareBps", "buybackBurnBps", "isNativeQuote"]),
+      this.readMany(l.curve, curveAbi, ["getReserves", "realQuoteReserve", "graduated", "readyToGraduate", "launchedAt", "currentSnipeTaxBps", "snipeTaxStartBps", "snipeTaxSeconds", "feeBps", "creatorTaxBps", "phantomQuote", "reservedTokens", "sellableTokens", "protocolFeeShareBps", "buybackBurnBps", "buybackEnabled", "isNativeQuote"]),
       this.hookAddress(),
       this.quoteAsset(l.pairToken),
     ]);
@@ -609,7 +609,12 @@ export class Parabolic {
     const currentSnipeBps = num(c.currentSnipeTaxBps);
     const protocolShareBps = num(c.protocolFeeShareBps);
     const buybackBurnBps = num(c.buybackBurnBps);
-    const buybackOfFeeBps = Math.round(((10_000 - protocolShareBps) * buybackBurnBps) / 10_000);
+    // The creator's switch, read off the curve (MONEY-5): a pre-17-Sep coin whose creator called
+    // `setBuybackEnabled(false)` earmarks no buyback slice, so its whole creator bucket is the creator's. The site
+    // and /api/v1 pass the same switch to `feeSplit` (web/lib/curve.ts); without it this tool showed 50/30/20 for a
+    // coin the site shows as 70/30.
+    const buybackEnabled = bool(c.buybackEnabled);
+    const buybackOfFeeBps = buybackEnabled ? Math.round(((10_000 - protocolShareBps) * buybackBurnBps) / 10_000) : 0;
     const poolId = l.poolFee !== undefined && l.tickSpacing !== undefined && hook ? poolIdOf(l.token, l.pairToken, l.poolFee, l.tickSpacing, hook) : undefined;
     const chainId = this.config.chainId;
     return {
@@ -644,7 +649,7 @@ export class Parabolic {
         feeBps: num(c.feeBps),
         creatorTaxBps: num(c.creatorTaxBps),
         split: { protocolBps: protocolShareBps, buybackBps: buybackOfFeeBps, creatorBps: 10_000 - protocolShareBps - buybackOfFeeBps, note: "shares of the base fee (and of snipe-tax revenue); the creator tax goes entirely to the creator" },
-        policy: { protocolFeeShareBps: protocolShareBps, buybackBurnBps },
+        policy: { protocolFeeShareBps: protocolShareBps, buybackBurnBps, buybackEnabled },
       },
       snipeTax: {
         currentBps: currentSnipeBps,

package/src/routed.ts

@@ -28,7 +28,7 @@ import { VENUES, VENUE_KEYS, isVenueKey, venueOn, type VenueChain, type VenueInf
  * encodes, argument for argument (test/routed.test.ts holds it against digests produced by the site's encoder, two
  * of which Foundry's `cast calldata` produced first). Two differences, both deliberate:
  *
- *  - **No voucher.** A Pro or Hyper voucher is a site feature signed for one wallet by the site's backend; this server
+ *  - **No voucher.** A Pro or Ultra voucher is a site feature signed for one wallet by the site's backend; this server
  *    sends the router's own "none" (a zeroed struct and an empty signature) and so pays the router's default fee,
  *    which it reads at every call rather than assuming.
  *  - **A plain allowance instead of a Permit2 signature** for an ERC-20 input (a USDG-quoted buy, every sell). The
@@ -434,7 +434,7 @@ export class RoutedTrades {
         minOut: { ...amount(minOut, outDecimals), slippageBps: Number(slippage) },
         ...(q.gross !== undefined ? { grossFromVenue: amount(q.gross, qd) } : {}),
         fees: {
-          parabolic: { bps: p.feeBps, ...amount(q.fee, qd), note: `Parabolic's routed fee: the router's defaultFeeBps, read now (the Free tier's; a Pro or Hyper voucher lowers it on the site, and this server sends none). Charged on the ${p.side === "buy" ? "input" : "venue's payout"}, on top of ${p.venue.name}'s own fee.` },
+          parabolic: { bps: p.feeBps, ...amount(q.fee, qd), note: `Parabolic's routed fee: the router's defaultFeeBps, read now (the Free tier's; a Pro or Ultra voucher lowers it on the site, and this server sends none). Charged on the ${p.side === "buy" ? "input" : "venue's payout"}, on top of ${p.venue.name}'s own fee.` },
           venue: { name: p.venue.name, ...(q.venueFee !== undefined ? amount(q.venueFee, qd) : { amount: null, raw: null }), note: p.via === "curve" ? `${p.venue.name}'s own curve fee and creator tax on this fill, read off the curve` : `${p.venue.name}'s hook takes its own fee on the pool swap (about ${p.venue.ownFeeBps} bps), already inside the quoted output` },
           snipeTax: { bps: q.snipeBps, note: q.snipeBps > 0 ? `${p.venue.name} charges a snipe tax on this buy right now, keyed on the RECIPIENT; it decays every second` : "none now" },
         },

package/src/server.ts

@@ -116,6 +116,12 @@ export function createServer(opts: ServerOptions = {}): McpServer {
   // Tool arguments are validated strictly: an argument the tool does not know (a misspelling, or
 // `referral` at the top level instead of inside `memo`) is an error, not something silently dropped
 // and quietly changing what the tool does.
+/**
+ * The creator-tax ceiling both factories answer today (`maxCreatorTaxBps()` 500 on 5042 and 4663, read 6 Oct 2026;
+ * CON-23). The schema refuses above it so an agent learns the bound before it builds a launch that reverts; the
+ * launch builder still reads the factory's own figure and refuses above that, which is what holds if an owner lowers it.
+ */
+const MAX_CREATOR_TAX_BPS = 500;
 const strictArgs = <T extends z.ZodRawShape>(shape: T) => z.object(shape).strict();
 
 const readOnly = { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true } as const;
@@ -227,7 +233,7 @@ const readOnly = { readOnlyHint: true, destructiveHint: false, idempotentHint: t
         socials: z.object({ twitter: z.string().max(256).optional(), telegram: z.string().max(256).optional(), discord: z.string().max(256).optional(), website: z.string().max(256).optional(), farcaster: z.string().max(256).optional() }).optional(),
         pair: z.enum(["USDC", "EURC"]).optional().describe("Which quote asset to launch against: \"USDC\" means the chain's gas token (native-quoted, which is USDC on Arc and is NOT a dollar on a chain paying gas in ETH), \"EURC\" the configured ERC-20. The answer's `quoteAsset` names what was actually resolved, read off the asset itself."),
         devBuy: whole.optional().describe("Creator's own first buy, whole quote units; returned as a second, snipe-tax-exempt transaction"),
-        creatorTaxBps: z.number().int().min(0).max(1000).optional().describe("Creator tax in basis points, 0–500 (5%) on the adopted parameters"),
+        creatorTaxBps: z.number().int().min(0).max(MAX_CREATOR_TAX_BPS).optional().describe(`Creator tax in basis points, 0 to ${MAX_CREATOR_TAX_BPS} (5%): both factories' maxCreatorTaxBps() read ${MAX_CREATOR_TAX_BPS}, and a higher figure reverts on chain`),
         creator: z.string().describe("Wallet that signs the launch; becomes deployer and creatorFeeRecipient"),
         buybackEnabled: z.boolean().optional().describe("Default true"),
         memo: z.object({ referral: z.string().optional().describe("Referrer's 16-hex referral code or wallet address"), note: z.string().max(280).optional().describe("Note kept on the coin; defaults to \"mcp\", which lists the coin on parabolic.family/agents") }).nullable().optional().describe("The memo-wrapped variant's referral and note (returned as `memo` beside `tx`); null leaves it out"),