MCP calculator beta

Typed calculator tools over JSON-RPC.

A read/calc-only MCP endpoint runs caller-supplied assumptions through valuation and financial calculator kernels. The endpoint is usable in beta; packaged third-party client integrations are not yet production-verified.

Manage API keys Developer contract

Tool names, arguments, and response shapes can change before general availability. Do not treat beta compatibility as an SLA.

Endpoint: POST /api/mcp
Server: 0.1.0-beta
Protocol: 2024-11-05
Mutation: None
Plan: Professional

Current beta boundary

What can and cannot happen through this endpoint.

Available

Discover valuation and financial calculator tools and resources.
Run stateless models, suites, formula explanations, and bounded sensitivity matrices.
Receive methodology or engine versions in structured results.
Use separate valuation and financial-calculator scopes.

Not available

No trading, order placement, watchlist changes, or workbook mutation.
No report generation, published-report reader, or on-demand ratings.
No licensed ticker defaults or historical backtests at launch.
No verified Claude Desktop, Cursor, Continue, or other packaged client setup.

Discoverable tool identifiers

Always call tools/list; this summary is not a substitute for the returned schema.

Caller-supplied calculations

calculate_asset_allocationcalculate_fd_vs_equity_returnscalculate_education_savingscalculate_child_education_monthly_investmentcalculate_compound_interestcalculate_cagrcalculate_gstcalculate_fixed_deposit_returnscalculate_recurring_deposit_returnscalculate_education_loan_emi

Registered, but launch-disabled

get_asset_allocation_model_portfoliosget_fd_vs_equity_market_defaultsget_education_savings_market_defaults

These source-backed tools return an entitlement or licensing denial in the launch configuration.

Authenticate and discover

Use the secret only in the X-API-Key header.

One included credential product

An active Professional subscription can create up to five scoped keys. There is no separate Growth API checkout. Each key has a 1,000-call monthly quota and per-minute abuse limits.

Secret lifecycle

Plaintext is shown only after creation or rotation. Account settings list prefix, scopes, monthly usage, reset date, last use, and status. Rotation invalidates the previous secret immediately; revocation is permanent.

export SMA_KEY="your-key-from-account-settings"

curl https://api.stockmarketagent.ai/api/mcp \
  -H "X-API-Key: ${SMA_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "initialize"
  }'

Operational guardrails

Beta does not mean unbounded.

64 KBMaximum JSON-RPC request body

9 × 9Maximum sensitivity matrix axes

12Maximum PEG peer rows

1,000Monthly calls per Professional key

Production browser-originated requests fail closed unless the operator explicitly allow-lists the Origin. Server and CLI clients normally omit Origin. Never place an API secret in browser code, a URL, source control, or chat history.

General-availability notice

Get one MCP launch email.

This is a separate double-opt-in request for the MCP launch notice, not enrollment in the weekly research digest.