Skip to main content
Glama
ferinator

BullRun

by ferinator

Bullrun MCP

A hosted remote MCP server that turns Claude (and other MCP clients) into a research analyst over global stocks, ETFs and your own portfolios.

Endpoint

https://mcp.bull-run.org/mcp — Streamable HTTP, OAuth 2.1 + PKCE

Web app

https://bull-run.org

Official MCP Registry

org.bull-run/bullrun

Glama connector

https://glama.ai/mcp/connectors/org.bull-run/bullrun

Privacy policy

https://bull-run.org/privacy

Bullrun is primarily a hosted service — there is nothing to install and no API key to manage for normal use. You point your MCP client at the remote endpoint and sign in with Google. This repository holds the connector's public metadata (server.json), connection docs, and a local stdio build of the MCP layer for directory/security checks. The Bullrun application and data services remain maintained separately.

Connect

Claude (web, Desktop, mobile) — requires a paid Claude plan:

  1. Settings → Connectors → Add custom connector

  2. Name it Bullrun, paste https://mcp.bull-run.org/mcp, and add it.

  3. Click Connect and complete the Google sign-in / authorize step.

Claude Code:

claude mcp add --transport http bullrun https://mcp.bull-run.org/mcp

Full setup for Cursor, VS Code, and the MCP Inspector is in docs/mcp-connect.md.

Related MCP server: Yahoo Finance MCP Server

What you can do once connected

Public market-data tools work for any connected client. The portfolio tools resolve your own Bullrun account after Google sign-in; the two draft tools require a Bullrun Pro account.

Stocks

Tool

What it does

screen_stocks

Screen the global universe by sector / industry / country / market cap; sort by P/E, dividend yield, revenue or revenue growth.

get_stock_metrics

Consolidated snapshot for one ticker — identity (ISIN/LEI/CIK), latest price, valuation, most recent financials, description.

get_financial_history

1–15 fiscal years of annual/quarterly statements, per-share metrics, margins, CAGRs and consistency checks.

get_quality_moat_metrics

ROIC, ROIC-vs-WACC spread, ROE/ROA, accruals, cash conversion, capex intensity, dividend payout/growth, buyback proxy.

get_forward_estimates

Consensus revenue / EPS / EBITDA, guidance, estimate revisions, and derived forward P/E & PEG context.

get_operating_kpis

Domain KPIs — ARR, net revenue retention, RPO, billings, customer counts, payment & cross-border volume.

get_revenue_breakdown

Segment, geography, product or customer revenue splits.

get_earnings_call_transcript

Speaker-tagged earnings-call transcript chunks, fiscal-period filters and text search.

ETFs and funds

Built for the way European investors actually shop for funds: by ISIN, by tracked index, and by total cost — with venue duplicates collapsed so one fund listed on six exchanges reads as one choice rather than six.

Tool

What it does

screen_etfs

Screen the whole fund universe by expense ratio, AUM, yield, trailing returns, volatility, liquidity, top-10 concentration and fund age, combined with issuer, index, domicile, UCITS status, distribution policy and currency hedging — plus look-through (holdingSearch) to find funds by what they hold.

get_etf_index_group

"Cheapest way to track the S&P 500 / MSCI World?" — every fund on one index, cheapest first, one row per fund with its venues, and an explicit count of funds that publish no fee.

get_etf_fund

Resolve an ISIN (or any venue ticker) to the fund and every exchange it trades on.

get_etf_filter_options

The exact values the categorical filters accept, so a screen never silently returns nothing on a guessed string.

search_etfs

Look up a known fund by name, ticker or ISIN, with classification, index, cost and yield filters.

get_etf_snapshot

Modular snapshot for one listing — identity, classification, market, NAV/AUM, costs, income, benchmark.

get_etf_holdings

Paginated constituents with an explicit partial-coverage contract.

get_etf_exposures

Holdings look-through to sector / country / issuer exposure.

get_etf_timeseries

Price history, with unavailable NAV / total-return / premium-discount series named rather than synthesized.

get_etf_risk

Volatility, drawdown, Sharpe/Sortino/Calmar, VaR, and benchmark-relative beta and tracking error.

compare_etfs

Side-by-side cost, performance, risk and holdings comparison.

analyze_etf_overlap

Shared holdings and a weighted lower-bound overlap between funds.

simulate_etf_cost

Deterministic multi-year cost scenario from expense ratio, spread, commission and contributions.

analyze_portfolio_fit

How a candidate fund would fit your existing portfolio. (sign-in)

query_etfs

Original ETF search. Retained for compatibility; prefer screen_etfs or search_etfs.

Your portfolios

Tool

What it does

get_capabilities

Which account is connected, whether Pro is active, granted scopes, and which tools are gated.

list_portfolios

Your virtual portfolios with value, day change, cost basis and total return. (sign-in)

get_portfolio_context

Deep snapshot of one portfolio: every holding with weight, sector and return, plus Bullrun's insights. (sign-in)

get_portfolio_analytics

Correlation/covariance, contribution-to-risk, factor exposure, sector/currency/country concentration, stress scenarios, and candidate-fit analysis. (sign-in)

create_portfolio_from_positions

Save a portfolio you have already decided, from an explicit {ticker, weight} basket used verbatim. (sign-in, no Pro needed)

create_portfolio_draft

Draft a new paper portfolio from a plain-English brief. Draft-only — saved for review, never changes a live position. (Pro)

create_position_draft

Suggest additions to an existing portfolio. Draft-only — saved for review. (Pro)

Authentication & privacy

The server is an OAuth 2.0 protected resource (RFC 9728). On first connect your client runs an automatic discovery handshake and sends you through Google sign-in; after you authorize, per-user tools resolve your Bullrun account. The MCP layer is a thin proxy with no database of its own — read tools return market data and your own holdings, the per-user read tools accept a privacyMode (full by default, or weights_only to return only relative figures), and the draft tools never mutate live holdings. See the privacy policy.

Local stdio build

The hosted endpoint above is the recommended integration. For directories that require building and running a local MCP server, this repo can run the MCP layer over stdio:

npm ci
npm run build
BULLRUN_API_BASE=https://bull-run.org node dist/stdio.js

Public market-data tools work without credentials. Portfolio and draft tools still require a Bullrun OAuth token in hosted clients and return an authentication-required error in anonymous stdio checks.

License

MIT.

Install Server
A
license - permissive license
A
quality
A
maintenance

Maintenance

Maintainers
Response time
Release cycle
1Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • A
    license
    B
    quality
    C
    maintenance
    MCP server that provides AI assistants access to stock market data including financial statements, stock prices, and market news through a Model Context Protocol interface.
    11
    2,276
    MIT
  • A
    license
    A
    quality
    A
    maintenance
    A simple MCP server for Yahoo Finance using yfinance. This server provides a set of tools to fetch stock data, news, and other financial information.
    15
    182
    MIT
  • F
    license
    Not graded
    quality
    D
    maintenance
    A Python-based FastMCP server that provides financial tools for securities analysis, including market data, news, fundamental/technical analysis, and visualization capabilities that can be consumed by any MCP-aware client.
    8
  • -
    license
    Not graded
    quality
    Not graded
    maintenance
    An MCP server that enables Amazon Q CLI users to create, query, and manage Maverick sites through natural language commands.

View all related MCP servers

Related MCP Connectors

  • Hosted MCP for stocks, options, Greeks, brokers, order previews, alerts, and workflows.

  • Multi-tenant FastMCP server for Charles Schwab brokerage data, monetized via DPYC Tollbooth

  • One MCP key: prices, fundamentals, SEC filings, insider/13F/congressional trades. 336 tools.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/ferinator/bullrun-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server