How do I use fiinquant-mcp?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@fiinquant-mcp get latest stock prices for FPT and VNM" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

fiinquant-mcp

by luongndcoder

Overview Schema Related Servers Score Discussions

Python

Remote

fiinquant-mcp (personal)

Personal resilient MCP server wrapping the FiinQuant / FiinQuantX Python SDK for Claude Desktop / Cursor (stdio).

Not an official FiinGroup/FiinQuant product. Tool surface aligned with official FiinQuant MCP domain tools, with timeout / error envelope / size budget so agent hosts do not hang.

Version: 0.2.1 (P0 + P1 + free-tier guards)

Quick start (uvx)

Requires uv.

{
  "mcpServers": {
    "fiinquant": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/luongndcoder/fiinquant-python-mcp",
        "fiinquant-mcp"
      ],
      "env": {
        "FIINQUANT_USERNAME": "your_user",
        "FIINQUANT_PASSWORD": "your_pass"
      }
    }
  }
}

Live data needs the private SDK wheel:

"args": [
  "--from", "git+https://github.com/luongndcoder/fiinquant-python-mcp",
  "--with", "/ABS/PATH/to/FiinQuantX.whl",
  "fiinquant-mcp"
]

See config/mcp.example.json and config/mcp.with-sdk.example.json.

Related MCP server: Daito

Tools (P0 + P1)

Domain	Tools
Health	`fq_ping`, `fq_session_status`, `fq_list_ops`
Market	`fq_get_price_history`, `fq_get_stock_prices`, `fq_get_market_statistics`, `fq_get_market_breadth`, `fq_get_index_constituents`, `fq_get_money_flow_contribution`, `fq_get_realtime_bid_ask`
Universe	`fq_list_tickers`, `fq_ticker_info`, `fq_get_basic_info`, `fq_get_icb_industries`
Fundamental	`fq_get_financial_ratios`, `fq_get_financial_statements`, `fq_get_valuation_timeseries`, `fq_get_equity_snapshot`
Screen / TA	`fq_screen_stocks`, `fq_get_technical_indicators`, `fq_detect_pattern`, `fq_get_rrg_analysis`, `fq_get_rebalance`, `fq_run_custom_analysis`
Meta	`fq_search_methods`, `fq_call_method`

~26 tools total. Names use fq_ prefix; semantics match official FiinQuant MCP domain tools.

Examples

fq_get_stock_prices tickers=FPT,VNM latest=true
fq_get_financial_ratios tickers=FPT years=2023,2024
fq_get_financial_statements tickers=FPT statement=income_statement
fq_screen_stocks filters=[{"indicator":"roe","operator":"gt","value":20}] limit=30
fq_get_technical_indicators tickers=VNM indicators=[{"name":"rsi","window":14}]
fq_get_index_constituents index=VN30

Responses:

{"ok": true, "data": ..., "meta": {"truncated": false, "row_count": 10}}

{"ok": false, "code": "TIMEOUT|AUTH|SDK_ERROR|VALIDATION|INTERNAL", "message": "...", "hint": "..."}

Architecture

Cursor / Claude Desktop
        │ stdio
        ▼
  uvx → fiinquant-mcp (FastMCP tools)
        │
        ▼
  FiinQuantGateway (session, timeout, re-auth, size budget)
        │
        ▼
  ops.py aliases → FiinQuantX / fiinquant SDK methods

If your SDK method names differ, edit src/fiinquant_mcp/ops.py or run:

python scripts/inventory_fiinquant_sdk.py

Free plan limits (default)

MCP defaults match FiinQuant Trải nghiệm / Miễn phí so agent tools don't burn quota:

Limit	Free tier
Connections	1 (single Gateway session)
Requests / month	100,000 (account-side)
Requests / minute	90 (enforced locally)
Requests / second	80 (enforced locally)
Realtime tickers / call	≤ 33
History depth	≤ 1 month (~31 days)
Timeframes	`1m`, `5m`, `15m`, `1h`, `4h` (+ Daily for EOD)

Over-limit calls return JSON VALIDATION or RATE_LIMIT with a hint — process stays up.

Upgrade? set FIINQUANT_PLAN=paid (or raise the override envs). Disable guards: FIINQUANT_ENFORCE_PLAN_LIMITS=false.

Environment

Variable	Default	Meaning
`FIINQUANT_USERNAME`	—	SDK username
`FIINQUANT_PASSWORD`	—	SDK password
`FIINQUANT_PLAN`	`free`	`free` \| `paid` — picks default caps
`FIINQUANT_ENFORCE_PLAN_LIMITS`	`true`	Local rate/history/ticker guards
`FIINQUANT_MAX_HISTORY_DAYS`	`31` (free)	Max `start`→`end` span
`FIINQUANT_MAX_REALTIME_TICKERS`	`33` (free)	Cap per realtime-ish call
`FIINQUANT_REQUESTS_PER_MINUTE`	`90`	Local RPM guard
`FIINQUANT_REQUESTS_PER_SECOND`	`80`	Local RPS guard
`FIINQUANT_TIMEOUT_S`	`30`	Hard timeout per call
`FIINQUANT_MAX_ROWS`	`500`	Max table rows
`FIINQUANT_MAX_CHARS`	`80000`	Max response chars
`FIINQUANT_LOG_LEVEL`	`INFO`	stderr logs

Develop

git clone https://github.com/luongndcoder/fiinquant-python-mcp.git
cd fiinquant-python-mcp
uv sync --extra dev
uv run pytest -v
uvx --from . fiinquant-mcp

License

MIT for this wrapper only. FiinQuant SDK and market data remain under FiinQuant terms.

Install Server

license - permissive license

quality

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

–Release cycle

–Releases (12mo)

Commit activity

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

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

Tools

View all tools

Latest Blog Posts

Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly
Lightport: Open-Sourcing Glama's AI Gateway
By punkpeye on April 27, 2026.
OpenAI
open source

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/luongndcoder/fiinquant-python-mcp'

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