FIU Finance Data

FIU Finance MCP Server 是深圳市融聚汇信息科技有限公司推出的金融市场数据 MCP 服务。通过 Streamable HTTP 端点，为 AI 模型提供港股、美股、A股（中华通）、日股、IPO 及全球基金数据，覆盖 100 个端点，支持工具自描述能力，让 AI 精准调用所需数据。

GitHub

Servidor MCP alojado

npx add-mcp 'https://ai.szfiu.com/api/mcp/v2'

Se instala en Claude Code, Codex, Cursor y más

Documentación

Servicio MCP de FIU Finance Data

Cobertura de cinco mercados financieros, 26 conjuntos de herramientas disponibles de una sola vez

¿Qué es el servicio MCP de FIU Finance Data?

FIU Finance MCP Server es el servicio MCP de datos de mercados financieros lanzado por Shenzhen Rongjuhui Information Technology Co., Ltd. A través del endpoint Streamable HTTP, proporciona a los modelos de IA datos de acciones de Hong Kong, acciones de EE. UU., acciones A (Stock Connect), acciones japonesas, IPO y fondos globales, cubriendo 100 endpoints, con capacidad de autodescripción de herramientas para que la IA pueda invocar con precisión los datos necesarios.

Las herramientas de negocio devuelven de forma unificada tres estados: la respuesta exitosa incluye code=0 y resultStatus, donde ok indica que hay datos, empty indica que la llamada fue exitosa pero sin datos de negocio y viene acompañada de emptyReason; los errores de parámetros y fallos downstream se devuelven a través de MCP isError=true, y el cuerpo del error incluye resultStatus=error. El sobre de estado no genera retrievedAt ni failedAt, y todas las respuestas exitosas y de error de las herramientas no devuelven el campo raw.

Capacidades principales

Cobertura de cinco mercados: Acciones de Hong Kong / EE. UU. / A (Stock Connect) / Japón / IPO
26 conjuntos de herramientas: Cotizaciones en tiempo real, velas K, estados financieros, estructura accionaria, flujo de fondos, cadena de opciones, ETF, bonos, noticias, calendario financiero, macroeconomía, etc.
Autodescripción de herramientas: Capacidad integrada de describe_tool, el modelo de IA puede consultar por sí mismo los parámetros, valores de enumeración y mercados aplicables de cualquier herramienta.
Protocolo Streamable HTTP: Protocolo MCP estándar, compatible con los principales clientes de IA.

Lista de herramientas

Este servicio proporciona 26 herramientas de datos financieros, cada una con múltiples endpoints, sumando más de 100 endpoints en total.

market_overview, market_flow, market_position_cost, shareholding_institution, macro_economics, company_announcements se completan directamente en el nivel superior con endpoint y los campos de negocio. market_ranking en el nivel superior solo conserva endpoint y params, y los campos de negocio se completan en params. describe_tool proporciona ejemplos de llamada según la estructura de la herramienta correspondiente.

Por ejemplo, para llamar a market_flow:

{"endpoint":"get_capital_flow","market":"HK","symbol":"00700.hk","flowType":"current"}

Los tipos de campo, enumeraciones completas, valores predeterminados y reglas de obligatoriedad condicional se rigen por la definición pública de parámetros de la herramienta y el contenido devuelto por describe_tool.

1. describe_tool — Autodescripción de herramientas

Ayuda al modelo de IA a conocer antes de la llamada los parámetros, valores de enumeración y el alcance de mercados aplicables de cualquier herramienta o endpoint. Admite dos niveles de detalle: summary (contrato de llamada compacto predeterminado, con tipos de parámetros, condiciones de obligatoriedad, enumeraciones completas y ubicación de la llamada), params (agrega descripciones semánticas y combinaciones válidas). Si se conoce el endpoint, se puede consultar directamente sus parámetros completos.

Parámetros de entrada

Parámetro	Tipo	Obligatorio	Descripción
`toolNames`	string[]	Uno de dos	Nombre del conjunto de herramientas o endpoint a consultar, máximo 5; usar preferentemente este campo.
`toolName`	string	Uno de dos	Nombre de un solo conjunto de herramientas o endpoint; se usa cuando no se completa toolNames.
`detail`	enum	No	Nivel de detalle de la respuesta: `summary` / `params`, predeterminado `summary`

Ejemplo de uso

"Ayúdame a ver qué parámetros necesitan los endpoints get_kline y get_financial_statement"

Meta-herramienta: search — Búsqueda de códigos de valores

Busca valores según el nombre de la empresa, código de valor o palabras clave parciales. Aplica cuando el usuario solo proporciona un nombre, un fragmento de código, o cuando se necesita resolver primero el código de valor estándar; si se conoce el symbol completo, se puede llamar directamente a la herramienta de negocio correspondiente.

Parámetros de entrada

Parámetro	Tipo	Obligatorio	Descripción
`key`	string	Sí	Palabra clave de búsqueda no vacía; admite nombre de empresa, código de valor, código completo con sufijo `.hk` / `.us` / `.sh` / `.sz` / `.jp` o palabras clave parciales, por ejemplo `腾讯`, `00700`, `AAPL.us`.

Descripción de la respuesta

Devuelve la lista de valores coincidentes; symbol incluirá el sufijo de mercado y puede usarse directamente como parámetro de entrada para herramientas de cotización, finanzas, noticias, etc. Si no hay coincidencias, devuelve resultStatus=empty, emptyReason=NO_MATCHING_DATA; errores de parámetros o anomalías del servicio devuelven un resultado de error.

Ejemplo de uso

"Busca el código de valor de Tencent" / "Encuentra el valor de EE. UU. correspondiente a AAPL.us"

2. quote_spot — Búsqueda de valores y cotización instantánea

Búsqueda de valores, definición estática, cotización instantánea y cotización ampliada. Admite consultas de precios en tiempo real para acciones, ETF, índices, warrants, bonos y otros tipos de activos, así como datos estáticos como definición de códigos de valores, doble mostrador y listas de nuevas emisiones. La cotización ampliada de acciones admite acciones de Hong Kong, EE. UU., A y Japón.

La cotización básica y ampliada de get_quote devuelve una tabla compacta: columns son los nombres de campo en inglés, columnNames son los nombres en chino correspondientes columna por columna, y rows[*][i] corresponde a columns[i].

Parámetros de entrada

Parámetro	Tipo	Obligatorio	Descripción
`endpoint`	string	Sí	`get_quote` / `get_security_definition` / `get_security_profile` / `search_security`
`params`	object	Sí	Incluye `market` (HK/US/CN/JP/GLOBAL), `assetType` (stock/etf/index/warrant/bond), `symbols` (array de códigos de valores), `quoteType` (basic=cotización básica, extended=cotización ampliada), `timeMode` (0=tiempo real, 1=retrasado, predeterminado 0), etc.

Ejemplo de cotización ampliada para acciones japonesas: {"endpoint":"get_quote","params":{"market":"JP","assetType":"stock","symbols":["6758.jp","7203.jp"],"quoteType":"extended","timeMode":0}}.

La cotización ampliada de acciones japonesas proporciona nombres de columna en chino para campos como relación de órdenes, capitalización de mercado flotante, rendimiento de dividendos, ganancias por acción y relación precio-beneficio. Los campos que están vacíos en todos los valores del mismo lote no se devuelven (incluidos null, valores faltantes, cadenas vacías y cadenas de solo espacios en blanco); si una columna tiene al menos un valor no vacío, se conserva y las otras filas se completan con null en la posición correspondiente, manteniendo la alineación de columns/columnNames/rows. 0 y false no se eliminan como valores vacíos.

Ejemplo de uso

"¿Cuánto vale Tencent Holdings ahora? Consulta las últimas cotizaciones de 00700.hk, AAPL.us y 600519.sh"

3. quote_intraday — Datos intradía en tiempo real

La consulta de get_trade_statistics para JP overview debe proporcionar symbol; el formato de date es YYYY-MM-DD, y si se omite se consulta el día actual en Japón. En días no hábiles puede no haber datos; para consultar operaciones históricas, especifica la fecha de negociación. type es 0=compra principal, 1=venta principal, 2=neutral, 3=compra y venta principal, 4=todos, predeterminado 4.

Libro de órdenes (bid/ask), registros de operaciones tick a tick, gráfico de tendencia intradía, mini gráfico de tendencia, estadísticas de negociación. Cubre acciones de Hong Kong, EE. UU., A (Stock Connect) y Japón, proporcionando datos intradía completos desde ticks de milisegundos hasta tendencias de nivel de minutos.

Parámetros de entrada

Parámetro	Tipo	Obligatorio	Descripción
`endpoint`	string	Sí	`get_intraday_trend` / `get_mini_trend` / `get_orderbook` / `get_trade_history` / `get_trade_statistics` / `get_trades`
`params`	object	Sí	Incluye `market`, `symbol`, `historyType` (trade), `statisticsType` (overview/detail), etc.

Ejemplo de uso

"Ayúdame a ver la profundidad actual de la cartera de órdenes de 00700.hk" / "Muestra el gráfico de tendencia intradía de AAPL hoy"

4. quote_kline — Datos de velas K

get_kline admite velas K de todos los períodos, desde 1 minuto hasta anual, con ajuste hacia adelante/hacia atrás/sin ajuste, máximo 500 velas por solicitud, cubriendo actualmente acciones, índices y bonos; para ETF se debe confirmar primero el endpoint. get_jp_kline consulta las últimas velas K de acciones japonesas, admite valores en lote; para instantáneas históricas se usa get_snapshot_history.

get_kline devuelve una tabla compacta: columns son los nombres de campo en inglés, columnNames son los nombres en chino correspondientes columna por columna, y rows[*][i] corresponde a columns[i].

Parámetros de entrada

Parámetro	Tipo	Obligatorio	Descripción
`endpoint`	string	Sí	`get_kline` / `get_jp_kline` / `get_snapshot_history`
`params`	object	Sí	`get_kline` incluye `assetType` (stock/index/bond), `symbol`, `period` (1m/3m/5m/15m/30m/60m/120m/240m/1d/1w/1mo/1q/1y), fecha límite `date`, `adjust` (none/forward/backward), `limit` (predeterminado 100, entero de 1 a 500).

get_kline acepta date=YYYY-MM-DD en todos los períodos; las velas de minutos también pueden especificar YYYY-MM-DD HH:mm:ss, y si solo se pasa la fecha indica hasta las 23:59:59 de ese día (fin del día natural, no el cierre de la bolsa). HK/US/CN/JP admiten acciones e índices, predeterminado assetType=stock; GLOBAL solo admite bonos, predeterminado assetType=bond. La vela diaria de CN usa por defecto adjust=forward, el resto usa none; la especificación explícita tiene prioridad. La fecha, la combinación de mercado y tipo de activo, y el número de velas se validan antes de ejecutar la solicitud.

Ejemplo de uso

"Ayúdame a ver las últimas 60 velas diarias de AAPL, con ajuste hacia adelante"

Parámetros de get_jp_kline

Parámetro	Tipo	Obligatorio	Descripción
`market`	string enum	No	Solo admite `JP` (acciones japonesas), predeterminado JP.
`date`	string	No	Fecha/hora de consulta. Cuando el tipo de vela es diario, semanal, mensual, trimestral o anual, la hora debe tener el formato "yyyy-MM-dd". Cuando el tipo de vela es de nivel de minutos, la hora debe tener el formato "yyyy-MM-dd HH:mm:ss".
`limit`	integer	No	Cantidad de registros a consultar, predeterminado 20, rango 1～500
`symbol`	string	Sí	Código de valor de una sola acción japonesa, por ejemplo `6758.jp`.
`symbols`	string[]	No	Lista de códigos en lote no vacía, por ejemplo `["6758.jp","7203.jp"]`; si también se completa symbol, symbol debe estar incluido en la lista.
`type`	integer enum	No	Tipo de vela: 0 (diaria), 1 (semanal), 2 (mensual), 3 (trimestral), 4 (anual), 5 (1 min), 6 (5 min), 7 (15 min), 8 (30 min), 9 (60 min), 10 (120 min), 11 (3 min), 12 (240 min).
`timeMode`	integer enum	No	0 (tiempo real), 1 (retrasado), predeterminado 0.

{"endpoint":"get_jp_kline","params":{"symbol":"6758.jp","symbols":["6758.jp","7203.jp"],"type":11,"limit":20,"timeMode":0}}

type predeterminado 0 (vela diaria). Si se omite date, se consulta la última vela K. Devuelve el nivel superior meta/format/columns/columnNames/rows, con datos fijos en las siguientes 13 columnas, en el mismo orden que la tabla. Los valores faltantes conservan null, los valores numéricos y de cadena mantienen su precisión original, y los demás campos de datos no se devuelven. El meta de un solo valor incluye symbol, market, period, count; en lote, los registros se concatenan según el orden de meta.symbols, meta.rowCounts corresponde al número de registros de cada valor (resultado vacío es 0), y meta.count es el número total de velas.

Campo de respuesta	Significado en chino
`amount`	Monto de operaciones
`amountLast`	Monto total de operaciones
`change`	Cambio
`changeRate`	Cambio porcentual
`close`	Precio de cierre
`date`	Fecha
`high`	Precio máximo
`low`	Precio mínimo
`open`	Precio de apertura
`preClose`	Precio de cierre anterior
`turnoverRate`	Tasa de rotación
`volume`	Volumen
`volumeLast`	Volumen total

5. quote_derivatives_hk — Derivados de Hong Kong

Directorio de emisores, listas de productos, información básica, datos históricos de negociación, estadísticas de clasificación y cotización ampliada de warrants (call/put) y CBBC. Enfocado en el mercado de derivados estructurados de Hong Kong.

Parámetros de entrada

Parámetro	Tipo	Obligatorio	Descripción
`endpoint`	string	Sí	`get_hk_warrant_catalog` / `get_hk_warrant_trading_data` / `get_quote_extend`
`params`	object	Sí	Incluye `warrantType` (issuer/list/list_en/profile), `warrantTradeType` (history/rank/statistics), `symbols`, etc.

Ejemplo de uso

"Ayúdame a encontrar todos los warrants y CBBC relacionados con Tencent" / "¿Cuáles son los diez warrants de Hong Kong con mayor volumen de operaciones?"

6. quote_us_options — Cadena de opciones de EE. UU.

Datos de la cadena de opciones OPRA de EE. UU.: lista de fechas de vencimiento, cadena de opciones, instantánea, griegas (Greeks), estadísticas de volumen de calls/puts, resumen de opciones, cotización en tiempo real, velas K y clasificaciones. Cubre todos los contratos de opciones del mercado de EE. UU.

Parámetros de entrada

Parámetro	Tipo	Obligatorio	Descripción
`endpoint`	string	Sí	`get_us_option_chain` / `get_us_option_overview` / `get_us_option_quote` / `get_us_option_rankings`
`params`	object	Sí	Incluye `optionType` (expiration/chain/symbols/snapshot/greeks/callput_volume), `rankType` (list/statistics/top10), `symbol`, etc.

Ejemplo de uso

"Consulta la cadena de opciones de AAPL, ¿qué fechas de vencimiento hay disponibles?" / "¿Cuál es el call de AAPL del mes cercano con mayor actividad de operaciones?"

7. market_overview — Resumen del mercado

Consulta el número de valores en alza y en baja en tiempo real y la distribución de cambios porcentuales para acciones de Hong Kong, EE. UU., A y Japón.

Parámetros de entrada

Parámetro	Tipo	Obligatorio	Descripción
`endpoint`	string	Sí	`get_market_statistics`
`market`	string enum	Sí	HK / US / CN / JP.

Devuelve el nivel superior columns/columnNames/rows, cada fila incluye market (código del rango estadístico) y marketName (descripción del mercado en chino), con las columnas correspondientes en la misma posición. Hong Kong muestra ALL=mercado completo, MAIN=tablero principal, GEM=tablero GEM; EE. UU. muestra ALL=mercado completo, Q=Nasdaq Global Select, G=Nasdaq Global, S=Nasdaq Capital, N=NYSE, A=NYSE MKT (AMEX), P=NYSE Arca, Z=BATS, V=Investor's Exchange; A y Japón muestran ALL=mercado completo. El mercado completo y los subsegmentos no deben sumarse repetidamente.

Campo de respuesta	Significado (x es el cambio porcentual)
`time`	Hora de actualización de la estadística, conserva el valor de tiempo original
`fall4`	Número de valores en el cuarto tramo de caída, x≤-7%
`fall3`	Número de valores en el tercer tramo de caída, -7%<x<-5%
`fall2`	Número de valores en el segundo tramo de caída, -5%≤x<-3%
`fall1`	Número de valores en el primer tramo de caída, -3%≤x<0%
`fall`	Número de valores en caída, x<0%
`flat`	Número de valores sin cambios, x=0%
`rise`	Número de valores en alza, x>0%
`rise1`	Número de valores en el primer tramo de alza, 0%<x≤3%
`rise2`	Número de valores en el segundo tramo de alza, 3%<x≤5%
`rise3`	Número de valores en el tercer tramo de alza, 5%<x<7%
`rise4`	Número de valores en el cuarto tramo de alza, x≥7%
`limitDown/limitUp`	Número de valores en límite de caída/subida disponible para acciones A

Cada rango conserva su propia hora de actualización; los valores faltantes conservan null y los datos vacíos no se rellenan con ceros. Si falla la consulta de cualquier rango, se devuelve un error.

Ejemplo de uso

"¿Cómo se comporta hoy el mercado de Hong Kong en general? ¿Cuántos valores suben y bajan?"

8. market_ranking — Clasificaciones multidimensionales

Cubre clasificaciones de acciones de Hong Kong, EE. UU., A y Japón. Solo se llama a la herramienta MCP market_ranking, con parámetros obligatorios de nivel superior endpoint:string enum y params:object; el mercado lo determina el endpoint, y rankType y los demás campos de negocio se colocan todos en params, sin necesidad de market. Los cuatro nombres de mercado son endpoints, no herramientas MCP independientes.

endpoint	params.rankType
`get_hk_ranking`	stock / industry / ipo / broker / market_premium
`get_us_ranking`	stock / industry / ipo / etf
`get_cn_ranking`	stock / industry / ipo
`get_jp_ranking`	stock / hot_stock / industry

Los campos de ordenamiento, tipo de activo, valores predeterminados y capacidad de paginación se validan según rankType. describe_tool consulta el conjunto de herramientas y devuelve el directorio de los cuatro mercados; al consultar el endpoint de un mercado, devuelve el diccionario completo de campos parameters, las variantes de tipos variants y todas las ramas oneOf, y se selecciona la restricción correspondiente según rankType. Por ejemplo, descripción de consulta: {"toolNames":["get_hk_ranking"],"detail":"params"}; llamada a market_ranking: {"endpoint":"get_hk_ranking","params":{"rankType":"stock","marketBoard":"MAIN","pageSize":10}}.

La respuesta se unifica como tabla compacta de nivel superior columns/columnNames/rows, conservando el total proporcionado por la interfaz, sin devolver el envoltorio semanticTool/data ni campos de paginación de navegación. Los parámetros completos, enumeraciones de mercado, reglas de compatibilidad y diferencias se describen en el Contrato de llamada de clasificación de mercado. La siguiente tabla de parámetros solo describe la entrada original de market_ranking.get_rankings, no se usa para las nuevas herramientas de mercado.

Parámetros de entrada

Parámetro	Tipo	Obligatorio	Descripción
`endpoint`	string	Sí	`get_rankings`
`market`	string enum	Sí	HK / US / CN / JP.
`rankType`	string enum	Sí	stock / industry / ipo / broker / market_premium / etf / hot_stock; la combinación específica por mercado se describe en la descripción de parámetros.
`marketBoard`	string	No	Código de segmento de mercado.
`assetType`	string enum	No	stock / etf / warrant / bond / trust / adr / common, predeterminado stock.
`stockKind`	string	No	Conjunto de acciones de EE. UU.
`conceptFlag`	string enum	No	Y=concepto, N=industria, predeterminado N.
`symbol`	string	No	Código de valor utilizado para clasificaciones como corredores.
`date`	string	No	Fecha de consulta, YYYY-MM-DD.
`price`	number	No	Precio especificado.
`types`	integer[]	No	Lista de períodos para clasificación de ETF de EE. UU., predeterminado [0].
`state`	string	No	Estado de negociación de acciones japonesas.
`sessionId`	integer enum	No	-1=premercado, 1=en mercado, -2=posmercado, predeterminado 1.
`sortField`	string enum	No	`changeRate` =cambio porcentual, `amount` =monto de operaciones, `volume` =volumen, predeterminado `changeRate`.
`sortType`	integer enum	No	0=ascendente, 1=descendente, predeterminado 1.
`timeMode`	integer enum	No	0=tiempo real, 1=retrasado, predeterminado 0.
`pageNum`	integer	No	Número de página, desde 1, predeterminado 1.
`pageSize`	integer	No	Cantidad por página, predeterminado 20, máximo 200.

Ejemplo de uso

"¿Cuáles son las diez acciones con mayor subida en Hong Kong hoy?" / "¿Qué sectores industriales de acciones A suben más?"

9. market_flow — Flujo de fondos

Flujo de fondos del día, flujo de fondos de los últimos 60 días y distribución de fondos de una sola acción. Admite acciones de Hong Kong, EE. UU., A y Japón.

El flujo de fondos se devuelve con una estructura de tabla compacta: columns son los nombres de campo en inglés, columnNames es el significado en chino correspondiente, y rows devuelve los datos por posición de columna. Los campos comunes incluyen: capitalBigFunds =flujo de fondos de órdenes grandes, capitalLargeFunds =flujo de fondos de órdenes muy grandes, capitalMidFunds =flujo de fondos de órdenes medianas, capitalSmallFunds =flujo de fondos de órdenes pequeñas, totalFunds =flujo de fondos general, changeRate =cambio porcentual, close =precio de cierre, date / time =hora; capitalInTotal =total de compras activas, capitalInLarge =compras activas de órdenes muy grandes, capitalInBig =compras activas de órdenes grandes, capitalInMid =compras activas de órdenes medianas, capitalInSmall =compras activas de órdenes pequeñas; capitalOutTotal =total de ventas activas, capitalOutLarge =ventas activas de órdenes muy grandes, capitalOutBig =ventas activas de órdenes grandes, capitalOutMid =ventas activas de órdenes medianas, capitalOutSmall =ventas activas de órdenes pequeñas.

Parámetros de entrada

Parámetro	Tipo	Obligatorio	Descripción
`endpoint`	string	Sí	`get_capital_flow`
`market`	string enum	Sí	HK / US / CN / JP.
`symbol`	string	Sí	Código de valor, índice o sector.
`flowType`	string enum	Sí	current=flujo de fondos del día, daily=flujo de fondos de los últimos 60 días, distribution=distribución de fondos.

Ejemplo de uso

"¿El flujo de fondos de 00700.hk está entrando o saliendo recientemente? ¿Cómo se mueven los fondos principales?"

10. market_structure — Estructura del mercado

指数成分股及映射关系、行业分类及行业成分股、市场微观结构（买卖价差、AH 溢价、双重柜台、券商列表）。支持港股、美股、A股（中华通）、日股。

输入参数

参数	类型	必填	说明
`endpoint`	string	是	`get_index_data` / `get_industry_data` / `get_market_microstructure`
`params`	object	是	包含 `market` 、 `indexType` （list/quote/constituent/mapping/capital_distribution）、 `industryType` （list/rank/constituent/belong_quote）、 `dataType` （spread/market_premium/double_counter/broker_list）等

使用示例

"恒生指数成分股有哪些？" / "贵州茅台属于哪个行业板块？"

11. market_position_cost — 持仓成本

筹码分布区间和筹码集中度分析，帮助判断支撑位、压力位和主力持仓成本。支持港股和美股市场。

输入参数

参数	类型	必填	说明
`endpoint`	string	是	`get_position_cost`
`market`	string enum	是	HK / US。
`symbol`	string	是	证券代码。
`costType`	string enum	是	range=指定价格获利比例、distribution=筹码移动分布。
`date`	string	否	查询日期，YYYY-MM-DD；默认今天。
`price`	number	条件必填	指定价格。
`high`	number	条件必填	最高价。
`low`	number	条件必填	最低价。

使用示例

"帮我看看 00700.hk 的筹码分布，当前持仓成本集中在什么区间？"

12. f10_profile — 公司概况

公司简介、管理层信息、扩展资料（并行数据、扩展全貌）和统一行业归属。覆盖港股、美股、A股（中华通），按市场自动汇总可用的公司资料，并清理空值和重复字段。

输入参数

参数	类型	必填	说明
`endpoint`	string	是	`get_company_profile` / `get_company_management` / `get_company_extra_profile`
`params`	object	是	包含 `market` 、 `symbol`

使用示例

"腾讯控股的公司简介和管理层有哪些人？" / "帮我查一下苹果公司的基本信息"

13. f10_financials — 财务报表

利润表（income）、资产负债表（balance）、现金流量表（cash）三大报表，以及 ROE、毛利率、净利率、资产负债率等关键财务比率指标。支持港股、美股、A股（中华通）。

get_financial_statement 和 get_financial_indicator 与行情域使用相同的顶层紧凑表契约，不再包含 semanticTool/data 包装： columns 是英文字段名， columnNames 是逐列对应的中文名， rows[*][i] 对应 columns[i] 。中文名优先采用清洗后的对应数据接口定义。完整财务表按元数据、资产、负债、权益、收入、成本费用、利润、经营/投资/融资现金流、现金汇总、每股指标、财务比率、调整项和其他字段排列，基础值与对应 YoY 字段相邻。

输入参数

参数	类型	必填	说明
`endpoint`	string	是	`get_financial_statement` / `get_financial_indicator`
`params`	object	是	包含 `market` 、 `symbol` 、 `statementType` （income/balance/cash，默认 income）、 `reportType` （HK: F/I/P/Q1-Q4；US: FY/I1/I2/Q1-Q4；CN: 1/6/9/12/99）等

三市场均支持通过 reportType 筛选报告期。返回行保留 coverMonths ： 3 表示单季， 6 表示前二季度/上半年累计， 9 表示前三季度累计， 12 表示前四季度/年报累计；美股第三季度数据按 coverMonths 区分第三季度单季和前三季度累计，并统一返回公开报告期 Q3 。存在明确口径时同时返回 periodScope （ quarter / cumulative ）和 periodDescription 。

使用示例

"贵州茅台最新一期利润表" / "腾讯近三年的 ROE 和毛利率变化趋势"

14. f10_business_governance — 业务与治理

主营业务收入分部分析、分红记录、拆股/合股历史、股东大会、持股变动、股份回购、股本结构等公司行为数据。覆盖港股、美股、A股（中华通）。

输入参数

参数	类型	必填	说明
`endpoint`	string	是	`get_business_segment` / `get_company_action`
`params`	object	是	包含 `market` 、 `symbol` 、 `actionType` （dividends/splits/meeting/hold_change/repurchase/share_structure）等

使用示例

"腾讯的业务收入主要来自哪些板块？" / "苹果近三年的分红记录"

15. shareholding_structure — 股权结构

主要股东、当前股东、股东详情、前十大股东，以及持股变动记录。覆盖港股、美股、A股（中华通），帮助了解公司股权集中度与大股东增减持动向。

输入参数

参数	类型	必填	说明
`endpoint`	string	是	`get_shareholders` / `get_shareholding_change`
`params`	object	是	包含 `market` 、 `symbol` 、 `holdingType` （major/current/detail/topten）等

使用示例

"腾讯的前十大股东是谁？" / "最近有没有大股东减持 00700.hk？"

16. shareholding_institution — 美股机构持仓

机构持股明细和机构持股统计。覆盖美股市场，展示机构投资者的持仓数量、比例、变动趋势，是跟踪美股机构动向的核心工具。

输入参数

参数	类型	必填	说明
`endpoint`	string	是	`get_institution_holding`
`market`	string enum	是	市场代码，目前只支持 US（美股）。
`holdingType`	string enum	是	detail=机构持股明细、statistics=机构持股统计。
`symbol`	string	是	证券代码，需带`.US` 或 `.us` 后缀，例如 AAPL.US。
`symbols`	string[]	否	批量证券代码列表，需带`.US` 或 `.us` 后缀，例如 ["BABA.US", "AAPL.us"]。

返回字段

holdingType=detail ： symbol 证券代码、 holderName 股东名称、 holdingNumber 持股数、 holdingRatio 持股比例、 changeNumber 变动股数、 changeRatio 变动比例、 reportDate 发布日期。

holdingType=statistics ： symbol 证券代码、 total 机构总数、 totalChange 机构总数较上期变动、 holdingNumber 持股数、 holdingNumberChange 持股数较上期变动、 holdingRatio 持股比例、 holdingRatioChange 持股比例较上期变动环比、 reportDate 报告日期、 neworgnum 新进机构数、 addedorgnum 增持机构数、 reduceorgnum 减持机构数、 price 股价。

使用示例

"有哪些机构持有 AAPL？最近机构是在加仓还是减仓？"

17. shareholding_fund_broker — 券商/沽空

券商持仓比例与排名、沽空（卖空）数据。覆盖港股和美股。基金持仓、基金成分、净值和业绩统一使用 fund_etf 。

输入参数

参数	类型	必填	说明
`endpoint`	string	是	`get_broker_holding` / `get_short_sell`
`params`	object	是	包含 `holdingType` （ratio/detail/statistics/rank/f10_ratio）、 `symbol` 等

使用示例

"00700.hk 的沽空比例是多少？" / "哪些券商席位持有腾讯？"

18. fund_etf — 基金与 ETF

全球基金搜索、基本资料、经理、分红、费率、净值、业绩、风险、完整持仓、资产/行业/国家配置、基准、销售市场、比较、排行、筛选与国家代码解析。基金按 fund_id 或 fund_class_id 查询，不使用交易市场字段；只有名称或 Ticker 时先搜索，已有稳定 ID 时直接调用目标 endpoint。

分层描述

describe_tool 可查询 fund_etf 工具集或单个 endpoint 的说明。已知 endpoint 时直接查询其完整参数，并根据 mode、operation 或 kind 的有效组合填写业务请求。无需每次重复读取工具集说明；已知参数可直接调用。

{"toolNames":["fund_etf"],"detail":"summary"}

{"toolNames":["get_fund_nav"],"detail":"params"}

基金 ID、业务分页和日期规则以单 endpoint 的参数说明为准。

紧凑返回

get_fund_nav(operation=history) 、 get_fund_holdings(operation=history) 、 rank_funds 、 screen_funds 返回顶层 format/columns/columnNames/rows ，不再使用 semanticTool/data 包装。 columns[i] 、 columnNames[i] 、 rows[*][i] 严格按位置对应。

保留实际返回的 meta （基金和份额标识、数据日期、估算标记、警告等）。
保留 page 、 page_size 、 has_more 、 next_page ，接口提供 total 时也保留；不自动翻页。
记录中的份额类别、币种、日期以及原始数值均保留，不跨份额、币种或日期汇总，不换算收益率、权重或币种；缺失值不填零。
空列表保留表结构、元数据及分页。未知字段保留，并显式标注缺少中文名。
最新净值、当前/前十大持仓及其余 endpoint 保持原有返回格式。

输入参数

参数	类型	必填	说明
`endpoint`	string	是	`search_funds` / `get_fund_profile` / `get_fund_managers` / `get_fund_distributions` / `get_fund_terms` / `get_fund_nav` / `get_fund_performance` / `compare_funds` / `get_fund_risk` / `rank_funds` / `screen_funds` / `get_fund_holdings` / `get_fund_exposure` / `get_fund_benchmark` / `get_fund_sales_markets` / `get_country_code`
`params`	object	是	基金引用使用 `fund_id` 或 `fund_class_id` ；分页使用 `page` （从 0 开始）和 `page_size` （最大 200）；日期使用 `start_date` / `end_date`

使用示例

"搜索代码为 DRAM 的基金，并查询它的完整持仓" / "比较这几只基金的资料和近一年表现"

19. stock_connect — 沪深港通

北向/南向资金额度使用、净成交额、累计净流入、持股比例、成交排名、持股变动率排名、资金流向分布。覆盖港股通和陆股通双向数据。

输入参数

参数	类型	必填	说明
`endpoint`	string	是	`get_stock_connect_data` / `get_hk_stock_connect_data` / `get_cn_stock_connect_data`
`params`	object	是	包含 `connectType` （minute_flow/balance/cumulative_net_turnover_in/cumulative_net_flow/net_turnover/rank_change_rate/rank_net_turnover_in/rank_shareholdings/rank_traded/shareholding_ratio/turnover_flow 等）、 `marketBoard` （ALL/SH/SZ）等

使用示例

"今天北向资金是流入还是流出？" / "沪股通持仓比例最高的 A 股有哪些？"

20. ipo — IPO 新股

港股和美股 IPO 日历、新股列表（招股中/待上市/已上市）、发行详情、公司资料、承销商/保荐人、基石投资者、孖展（融资）信息、排名、市场数据、认购工具、IPO 新闻、话题、课程和标签。覆盖 IPO 全流程，共 20 个端点。

输入参数

参数	类型	必填	说明
`endpoint`	string	是	`get_hk_ipo_calendar` / `get_hk_ipo_list` / `get_hk_ipo_detail` / `get_hk_ipo_company_profile` / `get_hk_ipo_underwriter` / `get_hk_ipo_cornerstone_investor` / `get_hk_ipo_margin_info` / `get_hk_ipo_notice` / `get_hk_ipo_rankings` / `get_hk_ipo_market_data` / `get_hk_ipo_subscription_tools` / `get_us_ipo_list` / `get_us_ipo_detail` / `get_us_ipo_underwriter` / `get_us_ipo_market_data` / `get_ipo_news` / `get_ipo_topic` / `get_ipo_course` / `get_ipo_tags` / `search_ipo_content`
`params`	object	是	包含 `ipoType` （calendar/make_new/today/to_be_listed/listed/offering/company_info/margin 等）、 `symbol` 、 `ipoMarketType` 、 `contentType` 等

使用示例

"本周港股有哪些新股在招股？" / "帮我查一下某 IPO 的基石投资者和孖展情况"

21. bond_basic — 债券基础

债券搜索、债券概况、快照报价、订单簿。使用 market=GLOBAL 进行跨市场债券查询，证券代码可使用 ISIN 编码。

输入参数

参数	类型	必填	说明
`endpoint`	string	是	`search_bond` / `get_bond_profile` / `get_bond_quote` / `get_bond_orderbook`
`params`	object	是	包含 `market` （GLOBAL）、 `symbol` （支持 ISIN）、 `keyword` 等

使用示例

"帮我搜索某 ISIN 对应的债券基本信息" / "查看这只债券的实时报价"

22. bond_analytics — 债券分析

债券排名、债券图表（收益率曲线等）、债券收益率、债券交易状态。使用 market=GLOBAL ，提供债券市场的深度分析功能。

输入参数

参数	类型	必填	说明
`endpoint`	string	是	`get_bond_rankings` / `get_bond_chart` / `get_bond_yield` / `get_bond_trading_status`
`params`	object	是	包含 `market` （GLOBAL）、 `symbol` 、 `chartType` 等

使用示例

"查看这只债券的收益率曲线" / "当前债券市场收益率排名"

23. fiu_news — 金融资讯

最新新闻、关键词搜索、语义搜索、个股相关新闻、新闻详情、关联新闻、新闻统计、新闻摘要。覆盖港股、美股、A股（中华通）、日股，支持标题/摘要/关键词搜索及语义级别的智能匹配，共 8 个端点。

输入参数

参数	类型	必填	说明
`endpoint`	string	是	`news_latest` / `news_search` / `news_semantic_search` / `news_by_symbol` / `news_get` / `news_related` / `news_count` / `news_digest`
`params`	object	是	包含 `market` （HK/US/CN/JP/GLOBAL）、 `query` （搜索关键词）、 `symbol` 、 `id` 、 `limit` （默认 10，最大 50）、 `hours` （默认 24，最大 168）等

使用示例

"最近 24 小时关于腾讯的新闻有哪些？" / "搜索港股市场关于 AI 的最新新闻"

24. financial_calendar — 财经日历

查询全球财经日历，支持按标题关键词、日期范围、国家/地区、市场、事件类型和重要等级筛选，并可按事件 ID 查询详情。覆盖经济数据发布、重要事件、权息和休市安排。

输入参数

参数	类型	必填	说明
`endpoint`	string	是	`search_financial_calendar` / `get_financial_event_detail`
`params`	object	是	搜索时 `date` （开始日期，YYYY-MM-DD）和 `keyword` （标题关键词）必填；可选 `endDate` 、 `direction` （-1=向未来，1=向历史）、 `limit` 、 `countryTypes` 、 `eventTypes` 、 `markets` 、 `importanceLevels` 。查询详情时传 `id` （搜索结果中的事件 ID）。

返回说明

搜索返回按日期组织的财经事件及事件 ID；详情接口返回单个事件的完整字段。未传 endDate 时使用 direction 和 limit 控制滚动日期窗口。

使用示例

"查询未来一周美国的重要经济数据" / "查看财经日历事件 ID 12345 的详情"

25. macro_economics — 宏观经济

查询精选宏观经济指标的最新数据，例如货币供应量、利率、通胀、就业、GDP、贸易和 PMI 等。

输入参数

参数	类型	必填	说明
`endpoint`	string	是	`get_macro_overview`
`titleId`	integer enum	是	宏观指标标题 ID：10=央行资产负债表、20=M2 同比、30=LPR、40=PPI、50=城镇调查失业率、60=固定资产投资、70=社会消费品零售、80=GDP、90=贸易余额、100=CPI、110=制造业 PMI。

返回说明

返回指定 titleId 指标的最新数据，内容包含指标名称、发布时间、数值及同比/环比等可用字段。

使用示例

"查询中国 CPI 最新数据" / "获取当前精选宏观经济指标"

company_announcements — 上市公司公告

查询港股、美股和 A 股上市公司公告。公告记录包含附件地址或正文；附件获取失败时保留该条公告并标记附件状态。

输入参数

参数	类型	必填	说明
`endpoint`	string enum	是	get_company_announcements。
`market`	string enum	是	HK / US / CN。
`symbols`	string[]	是	至少一个证券代码，例如 ["00700.hk"]。
`startDate`	string	否	公告开始日期，YYYY-MM-DD。
`endDate`	string	否	公告结束日期，YYYY-MM-DD。

调用示例

{"endpoint":"get_company_announcements","market":"HK","symbols":["00700.hk"]}

26. reference — 参考数据

ISIN/SEDOL/CIK 代码查询、货币代码、交易时段、除权日、退市记录、证券代码映射（股票/指数）、市场交易日历。覆盖港股、美股、A股（中华通）、日股，债券参考数据使用 market=GLOBAL ，共 4 个端点。

输入参数

参数	类型	必填	说明
`endpoint`	string	是	`get_reference_data` / `get_symbol_mapping` / `get_trading_status` / `get_market_hours`
`params`	object	是	包含 `referenceType` （isin/sedol/trade_symbol/warrant_related/currency/basic_symbol/cik/adr/bond_codes/yield_codes / stock/index）、 `statusType` （trade_date/session/exright/security/delisted/current/bond_session/yield_session）、 `symbol` 等

使用示例

"帮我查 00700.hk 的 ISIN 代码" / "今天港股是否交易日？交易时段是什么？"

接入配置

前置条件

访问 ai.szfiu.com 申请 API Key
HTTP 直连需要支持 Streamable HTTP 协议的 MCP 客户端
npm/npx 接入需要 Node.js 20.18.1 或更高版本

通过 npm/npx 接入

无需安装即可启动本地 stdio 适配器：

# macOS / Linux
FIU_API_KEY=YOUR_API_KEY npx -y fiu-finance-mcp

# Windows PowerShell
$env:FIU_API_KEY="YOUR_API_KEY"
npx -y fiu-finance-mcp

也可以全局安装：

npm install -g fiu-finance-mcp
fiu-finance-mcp --api-key YOUR_API_KEY

Claude Desktop、Cursor 等使用 stdio 的客户端可配置为：

{
  "mcpServers": {
    "fiu-finance": {
      "command": "npx",
      "args": ["-y", "fiu-finance-mcp"],
      "env": {
        "FIU_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

CLI 参数：

参数	说明
`-k, --api-key <key>`	FIU API Key，优先级高于 `FIU_API_KEY` 环境变量
`-u, --url <url>`	覆盖远程 MCP 地址，默认 `https://ai.szfiu.com/api/mcp/v2`
`--header <Name:Value>`	添加自定义请求头，可重复使用并支持 `${ENV_NAME}`
`--debug`	启用代理调试日志
`--silent`	仅输出错误日志
`-h, --help`	显示帮助
`-v, --version`	显示 CLI 版本

--connect-timeout 、 --headers-timeout 、 --body-timeout 、 --keep-alive 、 --ping-interval 、 --ipv4 和 --ignore-tool 等参数会传递给底层代理。

Streamable HTTP 直连

在 MCP 客户端配置文件中添加：

{
  "mcpServers": {
    "fiu-finance": {
      "type": "streamableHttp",
      "url": "https://ai.szfiu.com/api/mcp/v2",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Claude Code 一行命令接入：

claude mcp add --transport http fiu-finance https://ai.szfiu.com/api/mcp/v2 \
  --header "Authorization: Bearer YOUR_API_KEY"

配置完成后重启 MCP 客户端即可使用。

认证方式

API Key 认证：在 HTTP Header 中传入 Authorization: Bearer YOUR_API_KEY ，每个请求均需携带。

服务端说明

本仓库包含 npm CLI 客户端适配层，不包含业务服务端源码。服务端由深圳市融聚汇信息科技有限公司统一维护和运营，客户通过 API Key 接入后即可使用全部功能。

兼容平台

Claude Code、Claude Desktop、Cherry Studio、Cursor、ChatWise 及任何支持 Streamable HTTP 协议的 MCP 客户端。

版本信息

MCP 服务：v2.0.0
npm CLI：v1.0.0

服务开通

访问 https://ai.szfiu.com 查看定价方案并申请 API Key。

通信协议

MCP Streamable HTTP 协议

FIU Finance Data

Servidor MCP alojado

Documentación

Servicio MCP de FIU Finance Data

¿Qué es el servicio MCP de FIU Finance Data?

Capacidades principales

Lista de herramientas

1. describe_tool — Autodescripción de herramientas

Meta-herramienta: search — Búsqueda de códigos de valores

2. quote_spot — Búsqueda de valores y cotización instantánea

3. quote_intraday — Datos intradía en tiempo real

4. quote_kline — Datos de velas K

5. quote_derivatives_hk — Derivados de Hong Kong

6. quote_us_options — Cadena de opciones de EE. UU.

7. market_overview — Resumen del mercado

8. market_ranking — Clasificaciones multidimensionales

9. market_flow — Flujo de fondos

10. market_structure — Estructura del mercado

11. market_position_cost — 持仓成本

12. f10_profile — 公司概况

13. f10_financials — 财务报表

14. f10_business_governance — 业务与治理

15. shareholding_structure — 股权结构

16. shareholding_institution — 美股机构持仓

17. shareholding_fund_broker — 券商/沽空

18. fund_etf — 基金与 ETF

19. stock_connect — 沪深港通

20. ipo — IPO 新股

21. bond_basic — 债券基础

22. bond_analytics — 债券分析

23. fiu_news — 金融资讯

24. financial_calendar — 财经日历

25. macro_economics — 宏观经济

company_announcements — 上市公司公告

26. reference — 参考数据

接入配置

前置条件

通过 npm/npx 接入

Streamable HTTP 直连

认证方式

服务端说明

兼容平台

版本信息

相关资源

服务开通

通信协议