VoiceBrief MCP
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@VoiceBrief MCP What's Apple's revenue?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
VoiceBrief MCP
A self-hosted Model Context Protocol server that answers spoken stock-fact questions — "what's Apple's revenue", "tell me about Tesla's financials" — grounded in the company's actual SEC 10-K filing, not a guess from a language model's training data.
Built for a voice agent, not a screen: every answer is a single natural
sentence with units spelled out in full. No markdown, no tables, no $391B —
a text-to-speech engine has no reliable way to pronounce an abbreviated unit
letter, so this server never emits one.
> "What's Apple's revenue?"
< "AAPL's revenue, from its most recent SEC filing, is $416 billion."
> "Tell me about Tesla's financials."
< "Based on TSLA's most recent SEC filing, it reported revenue of $97.7
billion, earnings per share of $2.01, a market cap of $1.0 trillion,
and a book value per share of $19.32."Why this exists
Voice assistants answering finance questions today either hallucinate a
number or read out a screen-shaped string a TTS engine mangles ("three
ninety one point zero B"). This server closes both gaps: it pulls figures
straight from SEC EDGAR's public XBRL API —
free, no key, no auth — and formats them the way a person would actually say
them out loud (lib/spokenNumbers.js).
It runs as a normal MCP stdio server, which means it works with any MCP client, not just one voice platform — Claude Desktop, an Alexa+ skill's agent runtime, Cursor, or anything else that speaks the protocol.
Related MCP server: Oxford Ledge MCP Server
Run it
No account, no API key, no cloud dependency beyond sec.gov and a free
quote endpoint.
git clone https://github.com/mjaack/voicebrief-mcp.git
cd voicebrief-mcp
node src/server.jsPoint any MCP client at it over stdio. For Claude Desktop
(claude_desktop_config.json):
{
"mcpServers": {
"voicebrief": {
"command": "node",
"args": ["/absolute/path/to/voicebrief-mcp/src/server.js"]
}
}
}Tools
Tool | Use for |
| One specific figure: |
| A short spoken overview of the company's key figures. |
Both accept a company name or ticker ("Apple" or "AAPL") and resolve it
against SEC EDGAR's own ticker list — no hardcoded company map to fall out of
date.
Protocol conformance
Implements MCP spec revision 2025-11-25:
Version negotiation — echoes back an older version a client pins (
2025-06-18,2025-03-26) rather than forcing the latest.SEP-1303 — a bad argument (missing company, invalid metric) comes back as a normal tool result with
isError: true, so the calling model can read what went wrong and self-correct, instead of a JSON-RPC protocol error it can only fail on.JSON Schema 2020-12 — every
inputSchemadeclares the$schemadialect explicitly.
test/protocol.test.js spawns the server as a real subprocess and drives the
actual stdio handshake — initialize, tools/list, tools/call — the same
way a real MCP client does, rather than unit-testing the handler functions in
isolation.
Test
npm test12 tests: pure-formatting unit tests for the spoken-number logic
(test/voiceStockBrief.test.js, no network) plus the end-to-end protocol
suite above, including one live call to SEC EDGAR to confirm the whole path
returns a real, current figure.
License
MIT.
Available Tools
2 toolsget_stock_metricARead-only
Answer one financial metric for a US public company, spoken as a single natural-language sentence grounded in that company's most recent SEC 10-K filing (via EDGAR's XBRL data) -- not a guess. Use for a specific spoken question like "what's Tesla's revenue" or "what's Apple's earnings per share". Metric must be one of: revenue, eps, book_value_per_share, market_cap, total_assets, total_liabilities, price.
Inputs: metric (required), company (required).
get_stock_snapshotARead-only
Give a short spoken financial snapshot of a US public company (revenue, earnings per share, market cap, book value per share) grounded in its most recent SEC 10-K filing. Use for a broad spoken question like "tell me about Apple's financials" rather than one specific figure.
Inputs: company (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 2 tools
get_stock_metric targets a single, specified metric while get_stock_snapshot returns a fixed multi-metric overview, so their primary intents are distinct. There is slight overlap because the snapshot includes several metrics that could also be requested individually, but the descriptions clearly separate specific from broad questions.
Both tools follow the same get_stock_<noun> pattern with clear, parallel names. There is no style mixing or vague verbing between the two.
Two tools is below the typical 3-15 well-scoped range and the server feels minimal, though its narrow voice-brief purpose limits the need for many tools. Each tool earns its place, but the set remains borderline thin.
All advertised metrics are directly queryable via get_stock_metric, and get_stock_snapshot covers the common broad summary. Custom multi-metric requests require repeated calls, but there are no dead ends for the stated domain.
Maintenance
Related MCP Connectors
SEC-grounded stock facts phrased as single spoken sentences for a voice assistant to read.
SEC & financial-data MCP: filings, financials, ownership, factors, fund letters, prompts.
Read, search, and compare SEC EDGAR filings, pull tables, and run AI analysis from any MCP client.
Research US-listed companies and funds with the StockPortfolio.pro MCP server. Tools cover SEC filing-grounded financials, filing timelines, company comparisons, watchlist screens, fund profiles, and cited filing questions. Filed figures include their fiscal period and EDGAR source URL; missing filing data is returned as null. Public tools work without authentication; optional API-key or OAuth access is supported. US-listed, USD-reporting companies only. Keyless access includes 3 free AI questions per rolling 30-day window. To get more now, choose the Dev plan ($19.99/month, 200 credits) at https://www.stockportfolio.pro/register?plan=dev, then follow https://www.stockportfolio.pro/docs/api-mcp to connect with OAuth or an API key. Or wait for the free allowance to renew.
Related MCP Servers
- FlicenseAqualityDmaintenanceEnables AI clients to retrieve SEC company profiles, filing listings, and structured XBRL financial statements via MCP tools.13-
- AlicenseNot gradedqualityBmaintenanceLets any MCP-speaking assistant look up SEC filings and fundamentals, 13F holdings, insider trades, BDC loan books, and U.S. government reference data from Treasury, FRED, FDIC, USAspending, USPTO and CFTC, with the source named on every answer. Most of its 29 tools run keyless against public sources, giving citations-backed answers without an account.61 PyPIMIT
- AlicenseNot gradedqualityBmaintenanceConnects filing search and financial research tools to MCP-compatible assistants, letting them look up companies, query annual, quarterly and trailing-twelve-month financials, and ask questions answered with citations traceable to original SEC filings. It also supports company comparisons, valuation assumptions, and language selection for the returned research.MIT
- FlicenseNot gradedqualityAmaintenanceEnables natural-language financial research across SEC filings, earnings transcripts, financial metrics, stock and crypto market data, stock news, and prediction markets, returning structured, source-backed answers within MCP clients.-