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_companiesFind companies by name or any identifier, largest first
get_companyIdentity, listing, market cap with its date, rank, latest annual figures with fiscal year and source
get_figuresLatest figures of up to 100 companies in 60 fields: valuation, margins, returns, growth, debt, scores
get_historyOne yearly figure over up to 30 years, each year with its source
run_screenThe formula screener: Return on equity > 15 AND Debt to equity < 0.5
company_eventsResults, filings, insider trades, layoffs, recalls, dividend and index changes of the last days
lookup_identifiersTickers, ISINs, LEIs, CIKs and Wikidata items to companies, with all their identifiers
search_economic_seriesUS releases (CPI, payrolls, GDP, claims) and other countries' series, by words
get_economic_seriesThe newest values of a series with its units, source and licence
economic_calendarUS releases due in the next 75 days and published in the last 45
list_fieldsThe 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.