Skip to main content
Glama
VoiceBrief MCP

VoiceBrief MCP

by mjaack

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.js

Point 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

get_stock_metric

One specific figure: revenue, eps, book_value_per_share, market_cap, total_assets, total_liabilities, price.

get_stock_snapshot

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 inputSchema declares the $schema dialect 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 test

12 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 tools
get_stock_metricA
Read-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_snapshotA
Read-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

    A4.4/5.0

    Scored across 2 tools

    Disambiguation4/5

    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.

    Naming Consistency5/5

    Both tools follow the same get_stock_<noun> pattern with clear, parallel names. There is no style mixing or vague verbing between the two.

    Tool Count3/5

    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.

    Completeness4/5

    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

    ActivityStale
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      B
      maintenance
      Lets 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 PyPI
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Connects 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
    • F
      license
      Not graded
      quality
      A
      maintenance
      Enables 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.
      -