evidinvest-com Calculations API
The Calculations API from evidinvest-com — 5 operation(s) for calculations.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/evidinvest-com:evidinvest-com-calculations-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: EvidInvest Financial Data Calculations API
version: 1.0.0
description: 'REST API exposing 54 financial data, valuation, SEC filing, and portfolio tools, every figure traceable to an SEC filing. Designed for AI agents and external LLMs. Two ways to pay: (1) Bearer API key from https://evidinvest.com/settings/api-keys, 1 MCP credit per call; (2) NO ACCOUNT NEEDED — pay per request with the Machine Payments Protocol (https://mpp.dev) on the /v1/paid/* routes. Prices are dynamic and quoted free at GET /v1/quote.'
contact:
name: EvidInvest
url: https://evidinvest.com
servers:
- url: https://mcp.evidinvest.com
description: Production
security:
- BearerAuth: []
tags:
- name: Calculations
paths:
/v1/tools/calculate_wacc:
post:
operationId: call_calculate_wacc
summary: Calculate Weighted Average Cost of Capital (WACC) for a company
tags:
- Calculations
x-mcp-title: Calculate WACC
x-mcp-annotations:
title: Calculate WACC
readOnlyHint: true
destructiveHint: false
idempotentHint: true
openWorldHint: false
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
arguments:
type: object
properties:
symbol:
type: string
description: Stock symbol (e.g., AAPL, MSFT)
riskFreeRate:
type: number
description: 'Risk-free rate (default: 0.045 or 4.5%)'
marketRiskPremium:
type: number
description: 'Market risk premium (default: 0.06 or 6%)'
required:
- symbol
required:
- arguments
responses:
'200':
description: Tool result
content:
application/json:
schema:
type: object
properties:
result: {}
toolName:
type: string
creditsUsed:
type: integer
required:
- result
- toolName
- creditsUsed
'400':
description: Invalid arguments — e.g. a fetch-mode filing search (no `query`) that names no document; the body says which fields to pass
'401':
description: Missing or invalid API key
'402':
description: No MCP credits remaining
'404':
description: Tool not found
'429':
description: Rate limit or monthly tool call limit reached
'500':
description: Tool execution error
/v1/tools/calculate_dcf:
post:
operationId: call_calculate_dcf
summary: Calculate DCF (Discounted Cash Flow) valuation with sensitivity analysis
tags:
- Calculations
x-mcp-title: Calculate DCF
x-mcp-annotations:
title: Calculate DCF
readOnlyHint: true
destructiveHint: false
idempotentHint: true
openWorldHint: false
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
arguments:
type: object
properties:
symbol:
type: string
description: Stock symbol (e.g., AAPL, MSFT)
revenueGrowthRate:
type: number
description: 'Revenue growth rate (default: 0.05 or 5%)'
terminalGrowthRate:
type: number
description: 'Terminal growth rate (default: 0.025 or 2.5%)'
discountRate:
type: number
description: 'Discount rate/WACC (default: calculated from company data)'
projectionYears:
type: number
description: 'Number of projection years (default: 5)'
required:
- symbol
required:
- arguments
responses:
'200':
description: Tool result
content:
application/json:
schema:
type: object
properties:
result: {}
toolName:
type: string
creditsUsed:
type: integer
required:
- result
- toolName
- creditsUsed
'400':
description: Invalid arguments — e.g. a fetch-mode filing search (no `query`) that names no document; the body says which fields to pass
'401':
description: Missing or invalid API key
'402':
description: No MCP credits remaining
'404':
description: Tool not found
'429':
description: Rate limit or monthly tool call limit reached
'500':
description: Tool execution error
/v1/tools/calculate_margin_of_safety:
post:
operationId: call_calculate_margin_of_safety
summary: Calculate Margin of Safety valuation using 7-step methodology
tags:
- Calculations
x-mcp-title: Margin of safety
x-mcp-annotations:
title: Margin of safety
readOnlyHint: true
destructiveHint: false
idempotentHint: true
openWorldHint: false
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
arguments:
type: object
properties:
symbol:
type: string
description: Stock symbol (e.g., AAPL, MSFT)
discountRate:
type: number
description: 'Discount rate (default: 0.10 or 10%)'
marginOfSafety:
type: number
description: 'Margin of safety percentage (default: 0.40 or 40%)'
projectionYears:
type: number
description: 'Number of projection years (default: 10)'
required:
- symbol
required:
- arguments
responses:
'200':
description: Tool result
content:
application/json:
schema:
type: object
properties:
result: {}
toolName:
type: string
creditsUsed:
type: integer
required:
- result
- toolName
- creditsUsed
'400':
description: Invalid arguments — e.g. a fetch-mode filing search (no `query`) that names no document; the body says which fields to pass
'401':
description: Missing or invalid API key
'402':
description: No MCP credits remaining
'404':
description: Tool not found
'429':
description: Rate limit or monthly tool call limit reached
'500':
description: Tool execution error
/v1/tools/calculate_comparables:
post:
operationId: call_calculate_comparables
summary: Calculate valuation using comparable company analysis (trading multiples)
tags:
- Calculations
x-mcp-title: Comparables valuation
x-mcp-annotations:
title: Comparables valuation
readOnlyHint: true
destructiveHint: false
idempotentHint: true
openWorldHint: false
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
arguments:
type: object
properties:
symbol:
type: string
description: Stock symbol (e.g., AAPL, MSFT)
multiple:
type: string
enum:
- pe
- ev_ebitda
- price_to_book
- price_to_sales
- all
description: 'Which multiple to use (default: all)'
required:
- symbol
required:
- arguments
responses:
'200':
description: Tool result
content:
application/json:
schema:
type: object
properties:
result: {}
toolName:
type: string
creditsUsed:
type: integer
required:
- result
- toolName
- creditsUsed
'400':
description: Invalid arguments — e.g. a fetch-mode filing search (no `query`) that names no document; the body says which fields to pass
'401':
description: Missing or invalid API key
'402':
description: No MCP credits remaining
'404':
description: Tool not found
'429':
description: Rate limit or monthly tool call limit reached
'500':
description: Tool execution error
/v1/tools/calculate_ddm:
post:
operationId: call_calculate_ddm
summary: Calculate Dividend Discount Model (DDM) valuation — Gordon Growth plus a…
description: Calculate Dividend Discount Model (DDM) valuation — Gordon Growth plus a two-stage variant. The annual dividend per share is pre-filled from the company's own 10-K/10-Q XBRL filings (the trailing four fiscal quarters, else the latest fiscal year; USD per-share figures only) and the growth rate from the filed five-year dividend-per-share CAGR; pass annualDividendPerShare or dividendGrowthRate to use your own figures instead. The output names the source of each input and cites the filing. Ex-dividend and payment dates are not filed and are not used. When no dividend per share is filed and none is passed, the tool returns a structured 'not available' payload rather than assuming zero; cash paid to shareholders is also in get_cash_flow (commondividendspaid).
tags:
- Calculations
x-mcp-title: Dividend discount model
x-mcp-annotations:
title: Dividend discount model
readOnlyHint: true
destructiveHint: false
idempotentHint: true
openWorldHint: false
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
arguments:
type: object
properties:
symbol:
type: string
description: Stock symbol (e.g., AAPL, MSFT)
annualDividendPerShare:
type: number
description: Optional. Annual dividend per share in USD per listed share, for a FULL year at the company's own payment cadence. When omitted, the filed trailing dividend per share is used; the output's annual_dividend_source says which (filed_ttm_quarters, filed_latest_fy or caller_supplied).
requiredReturn:
type: number
description: 'Required rate of return (default: 0.10 or 10%)'
dividendGrowthRate:
type: number
description: 'Optional expected annual dividend growth rate. When omitted: the filed five-year dividend-per-share CAGR if it is between 0 and requiredReturn minus one point, else 0.03. Must be below requiredReturn.'
required:
- symbol
required:
- arguments
responses:
'200':
description: Tool result
content:
application/json:
schema:
type: object
properties:
result: {}
toolName:
type: string
creditsUsed:
type: integer
required:
- result
- toolName
- creditsUsed
'400':
description: Invalid arguments — e.g. a fetch-mode filing search (no `query`) that names no document; the body says which fields to pass
'401':
description: Missing or invalid API key
'402':
description: No MCP credits remaining
'404':
description: Tool not found
'429':
description: Rate limit or monthly tool call limit reached
'500':
description: Tool execution error
components:
securitySchemes:
BearerAuth:
type: http
scheme: bearer
bearerFormat: EvidInvest API key (evid_sk_...)