Skip to content
value.today

AI assistant connector

value.today's data inside the assistant your team already uses, through the Model Context Protocol (MCP). Your assistant does the reasoning; value.today answers with dated, sourced figures.

1. Get a key

Make one on API keys and usage. Each tool call counts as one request on the key's day (a free key has 1,000); the handshake and the tool list are free. A team key shares the team's limit, and its usage shows under "mcp".

2. Add the connector

The server: https://www.value.today/mcp (Streamable HTTP, JSON answers, no session).

Claude Code

claude mcp add --transport http value-today https://www.value.today/mcp --header "Authorization: Bearer vt_your_key"

Cursor (~/.cursor/mcp.json) and other clients that take a URL and headers

{
  "mcpServers": {
    "value-today": {
      "url": "https://www.value.today/mcp",
      "headers": { "Authorization": "Bearer vt_your_key" }
    }
  }
}

VS Code (.vscode/mcp.json), which asks for the key and keeps it out of the file

{
  "inputs": [{ "type": "promptString", "id": "vt-key", "description": "value.today API key", "password": true }],
  "servers": {
    "value-today": {
      "type": "http",
      "url": "https://www.value.today/mcp",
      "headers": { "Authorization": "Bearer ${input:vt-key}" }
    }
  }
}

Clients that take only an address (some chat apps' custom connectors, Copilot Studio without headers)

https://www.value.today/mcp?api_key=vt_your_key

The key is part of the address there: use a key made for that one client, and withdraw it if the address is shared.

3. Ask

  • "Which US software companies have an operating margin above 25% and revenue growth above 15%? Show the fiscal years."
  • "Compare Nestlé, Unilever and Procter & Gamble on margins, returns and debt, and say how old each figure is."
  • "What happened at Boeing in the last 30 days, with sources?"
  • "Chart Microsoft's free cash flow over ten years." "When is the next US CPI release, and what did the last one say?"

Test it without an assistant

curl -s https://www.value.today/mcp -H "Authorization: Bearer vt_your_key" -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"run_screen","arguments":{"formula":"Return on equity > 20 AND Debt to equity < 0.5 AND Market cap > 10B","limit":5}}}'

The tools

  • search_companies

    Find companies by name or any identifier, largest first

  • get_company

    Identity, listing, market cap with its date, rank, latest annual figures with fiscal year and source

  • get_figures

    Latest figures of up to 100 companies in 60 fields: valuation, margins, returns, growth, debt, scores

  • get_history

    One yearly figure over up to 30 years, each year with its source

  • run_screen

    The formula screener: Return on equity > 15 AND Debt to equity < 0.5

  • company_events

    Results, filings, insider trades, layoffs, recalls, dividend and index changes of the last days

  • lookup_identifiers

    Tickers, ISINs, LEIs, CIKs and Wikidata items to companies, with all their identifiers

  • search_economic_series

    US releases (CPI, payrolls, GDP, claims) and other countries' series, by words

  • get_economic_series

    The newest values of a series with its units, source and licence

  • economic_calendar

    US releases due in the next 75 days and published in the last 45

  • list_fields

    The field keys the other tools accept, with units and definitions

What it does not do

It reads only: nothing can be changed through it. It serves what the API serves: no live prices, no short interest (FINRA's terms), no IMF series. value.today runs no language model here and sees only the tool calls your assistant makes.