PNL Toolkit

Measured conclusion: Deep-tested. L2 outcome: tools_ok.

Eight free investment and trading calculators with PNG charts and editable result links.

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "PNL Toolkit": {
      "url": "https://pnltoolkit.com/mcp",
      "transport": "streamable-http"
    }
  }
}

Measured tools (8)

• historical_return read-only

  Historical investment return using installed monthly closes, not live quotes. Asset ticker, start/end months YYYY-MM, amount in USD (unit=cash) or historical shares/coins (unit=coins), buying fee in percent, optional benchmark and total/price return basis. Omitted dates use calculator defaults clamped to asset/benchmark coverage. Returns data coverage/source metadata and the free calc-return PNG. Returns results, conditions, assumptions, an editable link, share page and PNG. No account access or order execution.

  Parameters:

  • end — string — End month, YYYY-MM. Must be within the installed data snapshot.
  • unit — string — cash for a dollar budget; coins for a coin or share quantity.
  • asset — string — Asset ticker. Available historical start dates vary by asset.
  • start — string — Start month, YYYY-MM.
  • amount — number — Dollar budget including fees, or coin/share quantity when unit is coins.
  • buyFee — number — Buying fee as a percentage, e.g. 0.1 means 0.1%.
  • benchmark — string — Optional benchmark asset.
  • returnBasis — string — total reinvests distributions; price excludes distributions.
  • include_image — boolean — Also inline a PNG no wider than 1000 pixels. Image URL is always returned.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• dca_backtest read-only

  Dollar-cost-averaging backtest using installed monthly closes, not live quotes. Asset ticker, start/end months YYYY-MM, initial deposit in USD, monthly in USD per purchase, frequency in months (1, 3 or 12), buying fee in percent, optional benchmark and total/price return basis. Initial deposit and first recurring purchase occur at the selected start month-end. Omitted dates use calculator defaults clamped to coverage. Returns data metadata and the free calc-dca PNG. Returns results, conditions, assumptions, an editable link, share page and PNG. No account access or order execution.

  Parameters:

  • end — string — End month, YYYY-MM. Must be within the installed data snapshot.
  • asset — string — Asset ticker. Available historical start dates vary by asset.
  • start — string — Start month, YYYY-MM.
  • buyFee — number — Buying fee as a percentage, e.g. 0.1 means 0.1%.
  • initial — number — Initial deposit in dollars.
  • monthly — number — Contribution in dollars per chosen frequency (DCA), or per month (compound interest).
  • benchmark — string — Optional benchmark asset.
  • frequency — number — Contribution interval in months: 1, 3 or 12.
  • returnBasis — string — total reinvests distributions; price excludes distributions.
  • include_image — boolean — Also inline a PNG no wider than 1000 pixels. Image URL is always returned.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• compound_interest read-only

  Compound interest in USD: initial dollars, monthly dollars, annual return/fees/inflation in percent, and whole years. Creates a free calc-compound PNG. Returns results, conditions, assumptions, an editable link, share page and PNG. No account access or order execution.

  Parameters:

  • rate — number — Assumed gross annual percentage return.
  • years — integer — Number of years, 1 to 40.
  • timing — string — Deposit at the beginning or end of each month.
  • monthly — number — Contribution in dollars per chosen frequency (DCA), or per month (compound interest).
  • annualFee — number — Annual asset fee in percent.
  • inflation — number — Assumed annual inflation in percent.
  • principal — number — Initial investment, or peak account balance for recovery, in dollars.
  • include_image — boolean — Also inline a PNG no wider than 1000 pixels. Image URL is always returned.
  • contributionGrowth — number — Annual increase in contributions, in percent.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• position_size read-only

  Position sizing for linear USD shares/coins: prices in USD, account risk in percent, fees/slippage in basis points, quantity increment in units. Returns results, conditions, assumptions, an editable link, share page and PNG. No account access or order execution.

  Parameters:

  • fee — number — Fee per fill in basis points; negative maker fees are rebates in the spread model.
  • risk — number — Loss budget as a percentage of the account.
  • stop — number — Stop price.
  • entry — number — Trade entry price.
  • target — number — Trade target price, or target inventory percentage for inventory quotes.
  • balance — number — Account balance in dollars.
  • slippage — number — Slippage per side in basis points.
  • unitStep — number — Quantity increment; 0 disables rounding.
  • direction — string — long or short.
  • maxLeverage — number — Maximum notional exposure divided by equity.
  • include_image — boolean — Also inline a PNG no wider than 1000 pixels. Image URL is always returned.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• trade_expectancy read-only

  Trade expectancy and fractional Kelly: balance in USD, win rate/buffer/cap in percent, wins/losses/cost in R, fraction 0–1. Returns results, conditions, assumptions, an editable link, share page and PNG. No account access or order execution.

  Parameters:

  • cost — number — Cost per trade in R units.
  • avgWin — number — Average winning trade in R units.
  • avgLoss — number — Average losing trade in R units.
  • balance — number — Account balance in dollars.
  • riskCap — number — Maximum account risk in percent.
  • winRate — number — Estimated win rate in percent.
  • fraction — number — Kelly multiplier, e.g. 0.25 for quarter Kelly.
  • winBuffer — number — Conservative reduction in win rate, in percentage points.
  • include_image — boolean — Also inline a PNG no wider than 1000 pixels. Image URL is always returned.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• drawdown_recovery read-only

  Drawdown recovery: balances/deposits in USD, drawdown and monthly return in percent, target horizon in whole months. Returns results, conditions, assumptions, an editable link, share page and PNG. No account access or order execution.

  Parameters:

  • loss — number — Drawdown in percent, from 0 to 100.
  • losses — integer — Number of consecutive losing trades.
  • current — number — Current base inventory percentage, or current balance in dollars in recovery.
  • scenario — string — drawdown, balance or streak.
  • principal — number — Initial investment, or peak account balance for recovery, in dollars.
  • riskPerTrade — number — Loss per trade as a percentage of remaining equity.
  • targetMonths — integer — Recovery target horizon in months.
  • include_image — boolean — Also inline a PNG no wider than 1000 pixels. Image URL is always returned.
  • monthlyReturn — number — Assumed net monthly return in percent; not a forecast.
  • monthlyDeposit — number — New monthly deposit in dollars.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• spread_and_fees read-only

  Round-trip spread economics: one-side notional in USD; full spread, fee per fill and adverse cost in basis points (1 bp = 0.01%). Negative fees are rebates. Returns results, conditions, assumptions, an editable link, share page and PNG. No account access or order execution.

  Parameters:

  • fee — number — Fee per fill in basis points; negative maker fees are rebates in the spread model.
  • spread — number — Full quoted spread in basis points.
  • adverse — number — Adverse-selection cost in basis points.
  • notional — number — One-side trade notional in dollars.
  • include_image — boolean — Also inline a PNG no wider than 1000 pixels. Image URL is always returned.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• inventory_quotes read-only

  Inventory quotes: mid and tick in USD, inventory weights in percent, spread/skew/cap in basis points. Skew is bps per 10 percentage points of inventory deviation. Returns results, conditions, assumptions, an editable link, share page and PNG. No account access or order execution.

  Parameters:

  • mid — number — Market mid price.
  • skew — number — Quote shift in basis points per 10 percentage points of inventory deviation.
  • spread — number — Full quoted spread in basis points.
  • target — number — Trade target price, or target inventory percentage for inventory quotes.
  • current — number — Current base inventory percentage, or current balance in dollars in recovery.
  • skewCap — number — Maximum quote-center shift in basis points.
  • tickSize — number — Price tick size; 0 disables rounding.
  • include_image — boolean — Also inline a PNG no wider than 1000 pixels. Image URL is always returned.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

Publisher website

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.