Brieff

S&P 500 financial data, SEC filings, and AI-generated analysis for Claude.

Website · Get API Key · MCP Docs

---

Quick Setup

Option 1: Claude Code Plugin (Recommended)

claude plugin install brieff

On first use, your browser will open to sign in to your Brieff account and authorize access. No API key needed.

Option 2: Claude Code (Manual MCP)

claude mcp add brieff --transport streamable-http https://getbrieff.com/mcp

Option 3: Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "brieff": {
      "type": "streamable-http",
      "url": "https://getbrieff.com/mcp"
    }
  }
}

Programmatic Access (For Developers)

For scripts, CI/CD pipelines, or direct API access, use an API key:

1. Go to getbrieff.com/en/dashboard
2. Sign in and create a new API key (starts with brff_)
3. Use it with REST API endpoints (/api/company, /api/filings, etc.)

Migration note: API key authentication for the MCP endpoint has been removed. If you were using an API key with the MCP plugin, reinstall the plugin and sign in via OAuth.

Rate Limits

Brieff uses tiered rate limiting. Limits are enforced per-user after OAuth authentication.

Tier	Daily Tool Calls	Rate Limit (req/min)	Max API Keys
Free	25	20	0
Pro	500	120	10
Enterprise	Unlimited	300	Unlimited

A pre-authentication IP-based burst limit of 100 req/min applies to all requests regardless of tier.

Available Skills

Skills are guided analysis workflows you can invoke as slash commands. They orchestrate multiple tools to produce comprehensive results.

Skill	Usage	Description
company-analysis	/brieff:company-analysis AAPL	Full company deep-dive: overview, financials, commentary, filings, geographic breakdown
filing-summary	/brieff:filing-summary 0000320193-24-000123	Summarize signals and risks from a specific SEC filing
sector-comparison	/brieff:sector-comparison AAPL,MSFT,GOOGL	Side-by-side comparison of multiple companies
geographic-risk	/brieff:geographic-risk AAPL	Analyze geographic revenue concentration and geopolitical risk
financial-health	/brieff:financial-health AAPL	Deep-dive into debt, margins, cash flow, and solvency
portfolio-analysis	/brieff:portfolio-analysis AAPL,MSFT,GOOGL,AMZN	Analyze portfolio diversification, sector balance, and risk
earnings-alert	/brieff:earnings-alert	Scan recent filings for notable signals and earnings surprises
market-overview	/brieff:market-overview	Full market snapshot: indices, sectors, factors, volatility, and credit signals
technical-analysis	/brieff:technical-analysis AAPL	Technical indicators and analyst consensus for a stock

Financial Analyst Agent

The plugin includes a financial-analyst agent that Claude automatically delegates to when it detects a financial analysis task. The agent:

• Knows all 16 Brieff tools and when to use each one
• Searches for companies by name if no ticker is provided
• Formats financial figures properly ($1.2B, not 1200000000)
• Presents both strengths and risks objectively
• Never provides investment advice - data and analysis only

You can also invoke it explicitly:

Use the financial-analyst agent to analyze NVIDIA's latest earnings

Available Tools

Company Data

Tool	Input	Description
get_company	ticker	Company overview: price, market cap, sector, P/E, 52-week range, beta, dividend yield
get_financials	ticker	Financial statements: income statement, balance sheet, cash flow
get_filings	ticker	List SEC filings (10-K, 10-Q, 8-K, etc.)
get_filing_signals	accession_number	AI-generated signals and risk factors from a specific filing
get_geographic	ticker, fiscal_year?	Geographic revenue breakdown by region/country
get_rankings	-	S&P 500 rankings: revenue, net income, market cap, EPS, FCF, operating cash flow, total assets, D/E
get_commentary	ticker	AI-generated commentary with scores: valuation, profitability, growth, financial health, dividends
search_companies	query	Search S&P 500 companies by name or ticker
get_latest_filings	limit?, offset?, form_types?, query?	Paginated recent SEC filings with optional filtering
get_technicals	ticker	Technical indicators: MA50, MA200, RSI-14, MACD, Bollinger Bands, EMA-10, ATR-14, short interest, volume, 52-week range, beta
get_analyst_consensus	ticker	Analyst consensus rating, price targets, rating distribution, recent upgrades/downgrades

Market Data

Tool	Input	Description
get_market_overview	-	S&P 500, Nasdaq 100, and Dow Jones index prices with daily changes
get_sector_performance	-	Performance of all 11 GICS sector ETFs with daily price changes
get_factor_performance	-	Factor ETFs: growth, value, momentum, quality, min volatility, high dividend, small cap
get_volatility	-	VIX family indicators (VIX, VIX9D, VIX3M) and term structure classification
get_credit_signals	-	High yield and investment grade bond ETFs with HYG/SPY divergence signal

Available Prompts

Prompts are multi-step analysis workflows that guide Claude through a structured research process.

Prompt	Input	What it does
company-analysis	ticker	Full company deep-dive: overview, financials, commentary, filings, geographic breakdown
filing-summary	accession_number	Summarize and synthesize signals from a specific SEC filing
sector-comparison	comma-separated tickers	Side-by-side comparison of multiple companies
geographic-risk-analysis	ticker	Geopolitical risk analysis based on geographic revenue exposure
financial-health-check	ticker	Deep-dive into debt, margins, and cash flow health
trading-signal	ticker, risk_tolerance	Multi-perspective trading signal (technical, fundamental, sentiment, macro)

Example Usage

Once configured, you can ask Claude things like:

• "Analyze Apple's latest financial performance"
• "Compare MSFT, GOOGL, and AMZN side by side"
• "What are the key risk factors in Tesla's latest 10-K?"
• "Which S&P 500 companies have the highest free cash flow?"
• "Show me NVIDIA's geographic revenue breakdown"
• "Analyze my portfolio: AAPL, MSFT, GOOGL, AMZN, NVDA"
• "Any notable signals in recent SEC filings?"
• "How is the market doing today?"
• "Which sectors are outperforming?"
• "What does the VIX term structure look like?"
• "Give me the technical analysis for TSLA"
• "What's the analyst consensus on META?"

How It Works

Brieff uses the Model Context Protocol to give Claude direct access to financial data. Data is sourced from SEC EDGAR filings and Yahoo Finance, covering all S&P 500 companies.

Claude <-> MCP Protocol <-> Brieff API <-> SEC EDGAR + Yahoo Finance

License

MIT