Skip to main content
Glama
Infoway MCP Server

Infoway MCP Server

Official
by infoway-api

Infoway MCP Server

MCP (Model Context Protocol) Server that gives Claude and other AI assistants access to real-time financial data through the Infoway API. Query stock prices, crypto markets, forex, market sentiment, sector analysis, and company fundamentals -- all from within your AI conversation.

Features

  • 17 financial data tools covering real-time quotes, K-line charts, market overview, sector analysis, and stock fundamentals

  • Multi-market support: US, HK, CN, SG, JP, IN equities + crypto + forex

  • Zero configuration: just add your API key and start asking questions

  • Works with Claude Desktop, Cursor, and any MCP-compatible client

Related MCP server: Financial Modeling Prep MCP Server

Requirements

  • Python 3.10+

  • mcp 1.x — the server pins mcp>=1.0,<2. mcp 2.x removed the low-level handler decorators this server is built on, so an unpinned install resolves to 2.x and the server fails to start.

  • infoway-sdk >= 0.2.0

Installation

# Using uvx (recommended)
uvx infoway-mcp-server

# Using pip
pip install infoway-mcp-server

Upgrading from 0.1.0? Do upgrade. 0.1.0 shipped without the mcp<2 bound, so fresh installs pick up mcp 2.x and the server exits at import time — Claude Desktop shows it greyed out with no error. pip install -U infoway-mcp-server fixes it.

Configuration

Claude Desktop

Add the following to your Claude Desktop configuration file:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

  • Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "infoway": {
      "command": "uvx",
      "args": ["infoway-mcp-server"],
      "env": {
        "INFOWAY_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Cursor

Add to your Cursor MCP settings (.cursor/mcp.json):

{
  "mcpServers": {
    "infoway": {
      "command": "uvx",
      "args": ["infoway-mcp-server"],
      "env": {
        "INFOWAY_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Available Tools

Real-Time Market Data

Tool

Description

get_realtime_trade

Latest trade per symbol: s, t (epoch ms), p (price), v (volume), vw (turnover), td. No percent-move field is returned

get_market_depth

Order book: a (asks) / b (bids), each column-oriented as [[prices…],[quantities…]]

get_kline

Candles under respList (1m to yearly). Multiple codes in one call are truncated by the server to 2 candles per product — query one code at a time for history

Market Overview

Tool

Description

get_market_temperature

Market sentiment and heat indicators for HK, US, CN, SG

get_market_breadth

Advance/decline statistics for a market

get_global_indexes

Real-time data for major global indexes (Dow, S&P, Nasdaq, HSI, etc.)

get_leading_industries

Top-performing industry sectors ranked by performance

Sector / Plate Analysis

Tool

Description

get_industry_list

Full list of industry sectors with performance data

get_concept_list

Thematic/concept sectors (AI, EV, Metaverse, etc.)

get_plate_members

Stocks within a sector/plate. Paginated: takes offset/limit, returns total alongside members

get_plate_heatmap

Sector heatmap data for market visualization

Stock Fundamentals

Tool

Description

get_company_overview

Company profile, description, CEO, headquarters, key metrics

get_stock_valuation

Valuation ratios: P/E, P/B, EV/EBITDA, dividend yield, market cap

get_stock_ratings

Analyst consensus: buy/sell/hold counts, target price

get_stock_panorama

Comprehensive stock summary with key financial data

get_stock_drivers

Key price drivers and catalysts affecting the stock

Utilities

Tool

Description

search_symbols

List every instrument of one type. Requires type — one of STOCK_US, STOCK_CN, STOCK_HK, STOCK_JP, STOCK_KS, STOCK_IN, CRYPTO, FOREX, FUTURES (an instrument type, not a bare market code)

Symbol Conventions

Market

Format

Example

Hong Kong

zero-padded to 5 digits + .HK

00700.HK (700.HK is rejected with All product not exists)

US

ticker + .US

AAPL.US

China A-share

code + .SH / .SZ

600519.SH

Japan

code + .JP

7203.JP

India

ticker + .IN

RELIANCE.IN

Crypto

pair, no suffix

BTCUSDT

Forex / metals

pair, no suffix

USDJPY, XAUUSD

Example Conversations

Once configured, you can ask Claude questions like:

"What's the current price of Apple and Tesla?" Claude will use get_realtime_trade with codes AAPL.US,TSLA.US

"Show me the daily K-line for Bitcoin over the last 30 days" Claude will use get_kline with codes BTCUSDT, market_type crypto, kline_type 8, count 30

"How is the US market doing today? Which sectors are leading?" Claude will use get_market_temperature and get_leading_industries for market US

"Give me a full analysis of Tencent" Claude will combine get_company_overview, get_stock_valuation, get_stock_ratings, and get_stock_drivers for 00700.HK

"Compare the valuation of NVIDIA vs AMD" Claude will call get_stock_valuation for both NVDA.US and AMD.US

Get Your API Key

Get your free API key at infoway.io -- includes a 7-day free trial with full access to all endpoints.

Development

# Clone and install in development mode
git clone https://github.com/infoway-api/infoway-mcp-server.git
cd infoway-mcp-server
python -m venv .venv && source .venv/bin/activate
pip install -e ".[dev]"

# Run the test suite (no API key needed -- fixtures are recorded production responses)
python -m pytest tests/ -q

# Run directly
infoway-mcp-server

# Or with Python
python -m infoway_mcp_server.server

tests/test_smoke.py is the dependency-drift guard: it imports the server, asserts the installed mcp major version is still 1, and asserts all 17 tools register. If a future dependency bump breaks the handler API again, that test fails instead of the tools silently disappearing from Claude Desktop.


Infoway MCP Server (中文)

MCP(模型上下文协议)服务器,让 Claude 和其他 AI 助手可以通过 Infoway API 访问实时金融数据。在 AI 对话中即可查询股票价格、加密货币行情、外汇、市场情绪、板块分析和公司基本面。

功能特点

  • 17 个金融数据工具,涵盖实时行情、K线图、市场概览、板块分析和个股基本面

  • 多市场支持:美股、港股、A股、新加坡、日本、印度 + 加密货币 + 外汇

  • 零配置:只需添加 API Key 即可开始使用

  • 支持 Claude Desktop、Cursor 及所有兼容 MCP 协议的客户端

环境要求

  • Python 3.10+

  • mcp 1.x —— 本包已锁定 mcp>=1.0,<2。mcp 2.x 移除了本服务依赖的底层处理器装饰器, 不锁上界会解析到 2.x,服务启动即失败。

  • infoway-sdk >= 0.2.0

安装

# 使用 uvx(推荐)
uvx infoway-mcp-server

# 使用 pip
pip install infoway-mcp-server

如果你装的是 0.1.0,请务必升级:0.1.0 没有 mcp<2 上界,新装会拉到 mcp 2.x, 服务在 import 阶段就退出,Claude Desktop 里表现为服务变灰且没有任何报错。 执行 pip install -U infoway-mcp-server 即可修复。

配置 Claude Desktop

将以下内容添加到 Claude Desktop 配置文件:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

  • Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "infoway": {
      "command": "uvx",
      "args": ["infoway-mcp-server"],
      "env": {
        "INFOWAY_API_KEY": "你的API密钥"
      }
    }
  }
}

工具列表

实时行情

  • get_realtime_trade — 最新成交:s、t(毫秒时间戳)、p(价格)、v(成交量)、vw(成交额)、td;不返回涨跌幅字段

  • get_market_depth — 盘口深度:a(卖)/b(买),均为列式 [[价格…],[数量…]]

  • get_kline — K线数据在 respList 下,支持1分钟到年线;一次传多个代码时服务端只返回每个产品 2 根,要历史请逐个代码查询

市场概览

  • get_market_temperature — 市场温度/情绪指标

  • get_market_breadth — 市场涨跌统计

  • get_global_indexes — 全球主要指数实时数据

  • get_leading_industries — 领涨行业板块排名

板块分析

  • get_industry_list — 行业板块列表及涨跌数据

  • get_concept_list — 概念板块列表(AI、新能源车等)

  • get_plate_members — 板块成分股列表;分页接口,入参 offset/limit,返回 total 与 members

  • get_plate_heatmap — 板块热力图数据

个股基本面

  • get_company_overview — 公司简介与基本信息

  • get_stock_valuation — 估值指标(PE、PB、市值等)

  • get_stock_ratings — 分析师评级与目标价

  • get_stock_panorama — 个股全景数据概览

  • get_stock_drivers — 股价驱动因素分析

其他

  • search_symbols — 按品种类型列出全部交易标的;必传 type,取值为 STOCK_US、STOCK_CN、STOCK_HK、STOCK_JP、STOCK_KS、STOCK_IN、CRYPTO、FOREX、FUTURES(是品种类型,不是 US/HK 这类市场码)

代码格式约定

市场

格式

示例

港股

补零到 5 位 + .HK

00700.HK(700.HK 会报 All product not exists)

美股

代码 + .US

AAPL.US

A股

代码 + .SH / .SZ

600519.SH

日股

代码 + .JP

7203.JP

印度

代码 + .IN

RELIANCE.IN

加密货币

交易对,无后缀

BTCUSDT

外汇/贵金属

交易对,无后缀

USDJPY、XAUUSD

对话示例

"苹果和特斯拉现在什么价格?" Claude 会调用 get_realtime_trade,代码 AAPL.US,TSLA.US

"看一下比特币最近30天的日K线" Claude 会调用 get_kline,代码 BTCUSDT,market_type crypto

"今天美股表现怎么样?哪些板块领涨?" Claude 会调用 get_market_temperature 和 get_leading_industries

"帮我全面分析一下腾讯" Claude 会组合调用 get_company_overview、get_stock_valuation、get_stock_ratings、get_stock_drivers

获取 API Key

前往 infoway.io 免费注册获取 API Key,包含 7天免费试用,可访问全部接口。

License

MIT

Available Tools

17 tools
get_company_overviewA

Get company profile and overview including business description, CEO, employee count, founding date, headquarters, and key metrics.

Inputs: symbol (required).

get_concept_listA

Get the list of concept/thematic sectors for a market. Concepts are thematic groupings like 'AI', 'EV', 'Metaverse', etc.

Inputs: market (required), limit.

get_global_indexesA

Get real-time data for major global stock market indexes. Includes Dow Jones, S&P 500, Nasdaq, Hang Seng, SSE Composite, Nikkei, etc.

Inputs: no named parameters.

get_industry_listA

Get the full list of industry sectors for a market with their performance data. Includes change percentage, member count, and leader stocks.

Inputs: market (required), limit.

get_klineA

Get candlestick / K-line (OHLCV) data for given symbols. Supports multiple intervals: 1m, 5m, 15m, 30m, 1h, 2h, 4h, daily, weekly, monthly, quarterly, yearly.

Inputs: codes (required), market_type, kline_type, count.

get_leading_industriesA

Get top-performing industry sectors for a market, ranked by performance. Useful for identifying sector rotation and market leaders.

Inputs: market (required), limit.

get_market_breadthB

Get market breadth data showing advance/decline statistics. Includes number of advancing, declining, and unchanged stocks.

Inputs: market (required).

get_market_depthA

Get real-time order book / market depth (bid/ask levels) for given symbols. Returns arrays of bid and ask prices with their quantities.

Inputs: codes (required), market_type.

get_market_temperatureB

Get market temperature / sentiment overview for specified markets. Shows overall market heat, advance-decline ratios, and sentiment indicators. Useful for gauging whether the market is bullish or bearish.

Inputs: market.

get_plate_heatmapB

Get sector heatmap data for a market showing plate/sector performance. Useful for visualizing which sectors are hot or cold.

Inputs: market (required), limit.

get_plate_membersA

Get all stock members of a specific industry or concept plate/sector. Returns individual stocks with their price and change data.

Inputs: plate_symbol (required).

get_realtime_tradeA

Get real-time trade data for stocks, crypto, or forex. Returns latest price, volume, change, and timestamp for each symbol. Example codes: 'AAPL.US', 'BTCUSDT', '700.HK', 'USDJPY'.

Inputs: codes (required), market_type.

get_stock_driversB

Get the key price drivers and catalysts for a stock. Shows factors that are influencing the stock price movement.

Inputs: symbol (required).

get_stock_panoramaC

Get a panoramic summary of a stock including key financial data, performance metrics, and comprehensive stock overview.

Inputs: symbol (required).

get_stock_ratingsA

Get analyst ratings and consensus for a stock. Includes buy/sell/hold counts, target price, and rating distribution.

Inputs: symbol (required).

get_stock_valuationA

Get stock valuation metrics including P/E ratio, P/B ratio, market cap, EV/EBITDA, dividend yield, and other fundamental ratios.

Inputs: symbol (required).

search_symbolsA

Search and list available trading symbols. Returns symbols with their names, market, and type information. Optionally filter by market.

Inputs: market.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.5/5.0

    Scored across 17 tools

    Disambiguation5/5

    Each tool targets a distinct data category (e.g., company overview, market breadth, kline data) with no overlapping purposes. An agent can reliably select the correct tool based on the task.

    Naming Consistency4/5

    The vast majority of tools follow a consistent 'get_<noun>' pattern (e.g., get_kline, get_industry_list). One tool, 'search_symbols', deviates by using 'search' instead of 'get', but this is a minor inconsistency and still clear.

    Tool Count4/5

    With 17 tools, the server covers a comprehensive range of financial data endpoints without being overwhelming. The count is slightly high but justified by the breadth of data (market, company, sectors, real-time).

    Completeness3/5

    The tool set covers many important areas: real-time data, sector analysis, company overview, and valuation. However, it lacks fundamental financial statements (income, balance sheet), news, or earnings data, which are common in financial servers.

    Maintenance

    ActivitySlowing
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Provides AI agents with real-time financial market intelligence including stock quotes, crypto data, technical analysis, and portfolio insights. Enables natural language queries for current prices, technical indicators, asset comparisons, and portfolio analysis.
      17
      10
      MIT
    • A
      license
      Not graded
      quality
      A
      maintenance
      Enables AI assistants to access and analyze financial data, stock information, company fundamentals, and market insights through 250+ tools covering stocks, ETFs, crypto, forex, commodities, and economics.
      558 npm
      Apache 2.0
    • A
      license
      Not graded
      quality
      A
      maintenance
      Exposes 250+ financial data tools to AI assistants, enabling access and analysis of stocks, company fundamentals, ETFs, crypto, forex, commodities, economic indicators, and market insights.
      558 npm
      Apache 2.0
    • A
      license
      Not graded
      quality
      A
      maintenance
      Enables AI assistants to access and analyze financial data, stock information, company fundamentals, and market insights through 250+ tools covering stocks, ETFs, crypto, forex, commodities, and economics.
      558 npm
      Apache 2.0