Requires Node.js 18+ runtime environment to execute the MCP server
@byul/mcp
Compliant with the latest Model Context Protocol (MCP) specification.
Links
Overview
@byul/mcp is a stdio-based MCP server that proxies the Byul REST API. It exposes a small set of MCP tools and a resource that forward requests to Byul endpoints and return the original JSON response, plus a short article-count summary string.
Requirements
- Node.js 18+ 
- BYUL_API_KEYenvironment variable
Quick start
Configuration
Register this server as an MCP provider in your LLM client. The client will launch the server via stdio and communicate using JSON-RPC over stdin/stdout.
Parameters
- Tools (summary; see - @docsfor the full spec)- news_fetch→ proxies- GET /newswith filters:- limit,- cursor,- sinceId,- minImportance,- q,- symbol,- startDate,- endDate
 
- Resource (summary; see - @docsfor the full spec)- byul://news{?limit,cursor,sinceId,minImportance,q,symbol,startDate,endDate}
 
Each response contains:
- A summary string like “Returned N articles” 
- The original JSON payload from the Byul API 
Available Tools
news_fetch
- Description: Fetch latest financial news 
- Parameters: - limit(number, optional) – number of articles (1-100)
- cursor(string, optional) – pagination cursor from previous page
- sinceId(string, optional) – return articles created after this ID
- minImportance(number, optional) – minimum importance (1-10)
- q(string, optional) – search query
- symbol(string, optional) – stock symbol (e.g., AAPL)
- startDate(string, optional) – ISO 8601 start timestamp (UTC)
- endDate(string, optional) – ISO 8601 end timestamp (UTC)
 
- Example request: 
Security
- Provide the API key via the - BYUL_API_KEYenvironment variable only. Do not hardcode credentials in code or configs.
Platform setup
1) Cursor (latest)
~/.cursor/mcp.json or project .cursor/mcp.json:
2) Claude Code (VS Code extension)
CLI
Settings JSON
3) Claude Desktop
claude_desktop_config.json:
4) VS Code
Workspace .vscode/mcp.json:
5) Windsurf
windsurf_mcp.json:
6) Gemini CLI
~/.gemini/settings.json:
If the mcpServers object does not exist, create it. This package supports stdio (local) transport only.
Troubleshooting
- Missing API key - Error example: - Missing BYUL_API_KEY environment variable
- Fix: set - BYUL_API_KEYin your environment before launching the server
 
- Corporate proxy / firewall - npxmust reach the registry to download- @byul/mcpon first run; configure your proxy settings accordingly
 
- Windows / WSL path and env - PowerShell example: $env:BYUL_API_KEY = "byul_xxxxxxxxxxxxx" npx -y @byul/mcp
 
- Transport scope - This package covers only stdio transport. HTTP/SSE transports are intentionally not covered in this guide. 
 
Compliant with the latest Model Context Protocol (MCP) specification.
This server cannot be installed
local-only server
The server can only run on the client's local machine because it depends on local resources.
The Byul Finance MCP provides real-time financial data via the Byul API, including breaking economic news, the Fear & Greed Index, and an economic calendar for global events.
Related MCP Servers
- Asecurity-licenseAqualityA simple MCP server for Yahoo Finance using yfinance. This server provides a set of tools to fetch stock data, news, and other financial information.Last updated -566MIT License
- -security-license-qualityProvides real-time access to global stock market data including current prices, historical charts, and company financial information through a Model Context Protocol (MCP) server for AI assistants.
- Asecurity-licenseAqualityAn MCP server that provides comprehensive financial insights and analysis by leveraging real-time market data, news, and advanced analytics for stocks, options, financial statements, and economic indicators.Last updated -1747PythonMIT License
- Asecurity-licenseAqualityProvides real-time financial data to language models via MCP protocol, enabling access to stock prices, market indices, and financial news through Tushare API.Last updated -1419251MIT License