Financial News and Notes MCP

v1.0.0Finance & Fintechstable

A TypeScript-based MCP server that enables users to query financial news, stock data, and index information while managing text notes with creation and summarization capabilities.

binancedatafinancellmmcp
Share:
576
Stars
0
Downloads
0
Weekly
0/5

What is Financial News and Notes MCP?

Financial News and Notes MCP is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to typescript-based mcp server that enables users to query financial news, stock data, and index information while managing text notes with creation and summarization capabilities.

A TypeScript-based MCP server that enables users to query financial news, stock data, and index information while managing text notes with creation and summarization capabilities.

This server falls under the Finance & Fintech category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • A TypeScript-based MCP server that enables users to query fi

Use Cases

Financial news and stock data queries
Text note management with summarization
Multi-source data integration
LicenseMIT License
Languagejavascript
Versionv1.0.0
UpdatedMay 18, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx financial-news-and-notes-mcp-server

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Financial News and Notes MCP

Financial News and Notes MCP Server is a TypeScript-based MCP server that gives AI assistants access to 18 specialized financial data tools, covering A-share, US, Hong Kong, and crypto markets through the Tushare data platform. It exposes tools for real-time financial news, stock and index historical data, technical indicators (MACD, RSI, KDJ, BOLL, MA), macro-economic indicators, fund data, capital flow analysis, and margin trading data. Analysts and developers use it to bring institutional-grade Chinese market data into Claude and other MCP clients without writing custom data pipelines.

Prerequisites

  • Node.js 18 or higher installed
  • npm 9 or higher for global package installation
  • A Tushare account and API token (register free at tushare.pro — some data requires a pro account)
  • An MCP client such as Claude Desktop or Claude Code CLI
1

Get your Tushare API token

Register at tushare.pro, log in, and copy your API token from your account profile page. This token is required to access all financial data tools.

2

Install the finance-mcp package globally

Install the package globally via npm so the finance-mcp binary is available system-wide.

npm install -g finance-mcp
3

Add to your MCP client configuration

Edit your claude_desktop_config.json to register the finance-mcp server and pass your Tushare token as an environment variable.

{
  "mcpServers": {
    "finance-mcp": {
      "type": "stdio",
      "command": "finance-mcp",
      "env": {
        "TUSHARE_TOKEN": "your_tushare_token_here"
      }
    }
  }
}
4

Restart your MCP client

Restart Claude Desktop or Claude Code to load the server. The 18 financial data tools should appear in the available tools list.

5

(Optional) Install via Smithery

Alternatively, install and configure the server in one command using the Smithery CLI.

npx -y @smithery/cli install @guangxiangdebizi/FinanceMCP --client claude
6

(Optional) Use the free cloud service

Access the service without local installation at finvestai.top, which provides a public deployment with no setup required.

Financial News and Notes MCP Examples

Client configuration

Configuration entry for claude_desktop_config.json with the Tushare token passed as an environment variable.

{
  "mcpServers": {
    "finance-mcp": {
      "type": "stdio",
      "command": "finance-mcp",
      "env": {
        "TUSHARE_TOKEN": "your_tushare_token_here"
      }
    }
  }
}

Prompts to try

Use these prompts once the Financial News MCP server is connected to your AI assistant.

- "Analyze Moutai (600519.SH) with MACD(12,26,9), RSI(14), and KDJ(9,3,3) indicators over the last 60 days"
- "Get the latest 24/7 financial news and summarize the top market-moving stories"
- "Show capital flow data for the banking sector and tell me if institutions are net buyers or sellers"
- "Fetch BTC/USDT 15-minute candlestick data for the last 12 hours and identify support levels"
- "Find all CSI 300 index constituents and sort them by P/E ratio"
- "Look up fund manager Zhang Kun's current holdings and recent performance"

Troubleshooting Financial News and Notes MCP

API calls fail with 'token invalid' or 'permission denied' errors

Verify your TUSHARE_TOKEN is correct by testing it directly: curl -X POST https://api.tushare.pro -H 'Content-Type: application/json' -d '{"api_name":"trade_cal","token":"YOUR_TOKEN","params":{}}'. Some endpoints require a Tushare Pro subscription with sufficient points — check your account level at tushare.pro.

finance-mcp command not found after npm global install

Run 'npm bin -g' to find the global bin directory and ensure it is on your PATH. On macOS with Homebrew Node, global binaries are in /usr/local/bin or /opt/homebrew/bin. Alternatively use the full path in the MCP config command field.

Technical indicator data is missing or incomplete

Technical indicators like MACD and RSI require a sufficient history of price data to calculate correctly. Request at least 60 days of data for MACD and 30 days for RSI. The server performs smart prefetching, but very short date ranges will produce empty or incorrect indicator values.

Frequently Asked Questions about Financial News and Notes MCP

What is Financial News and Notes MCP?

Financial News and Notes MCP is a Model Context Protocol (MCP) server that typescript-based mcp server that enables users to query financial news, stock data, and index information while managing text notes with creation and summarization capabilities. It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Financial News and Notes MCP?

Follow the installation instructions on the Financial News and Notes MCP GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with Financial News and Notes MCP?

Financial News and Notes MCP works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Financial News and Notes MCP free to use?

Yes, Financial News and Notes MCP is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.

Browse More Finance & Fintech MCP Servers

Explore all finance & fintech servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "financial-news-and-notes-mcp-server": { "command": "npx", "args": ["-y", "financial-news-and-notes-mcp-server"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Financial News and Notes MCP?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides