{
  "markdown": "# AxionQuant MCP Server\n\n**Give Claude, ChatGPT, and other LLMs real-time financial data.** A Model Context Protocol (MCP) server for the [AxionQuant](https://axionquant.com) financial data API - covering stocks, crypto, forex, futures, indices, ETFs, economic data, news, sentiment, SEC filings, financials, insider trading, ESG, and credit ratings.\n\n[![npm version](https://img.shields.io/npm/v/@axionquant/mcp.svg)](https://www.npmjs.com/package/@axionquant/mcp)\n[![npm downloads](https://img.shields.io/npm/dm/@axionquant/mcp.svg)](https://www.npmjs.com/package/@axionquant/mcp)\n[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](#license)\n\n**[Website](https://axionquant.com)** · **[Documentation](https://axionquant.com/docs)** · **[Get an API Key](https://axionquant.com/dashboard/api-keys)**\n\nThe AxionQuant MCP server plugs directly into Claude Desktop and any other MCP-compatible client, letting an LLM answer natural-language financial questions - stock quotes, crypto prices, SEC filings, earnings transcripts, economic indicators, and more - using live data instead of stale training data.\n\n## Why AxionQuant MCP?\n\n- **100+ tools in one server** - market data, fundamentals, alternative data, and macro indicators across every major asset class\n- **Works with any MCP client** - Claude Desktop today, and any client that supports stdio transport\n- **Natural-language financial queries** - no need to learn an API schema; just ask\n- **One API key, one config block** - minimal setup to get an LLM talking to live market data\n\n## Table of Contents\n\n- [Installation](#installation)\n- [Configuration](#configuration)\n  - [Claude Desktop](#claude-desktop)\n  - [Other MCP Clients](#other-mcp-clients)\n- [Available Tools](#available-tools)\n- [Example Queries](#example-queries)\n- [Architecture](#architecture)\n- [Troubleshooting](#troubleshooting)\n- [FAQ](#faq)\n- [Get Started](#get-started)\n- [License](#license)\n\n## Installation\n\n```bash\nnpm i @axionquant/mcp\n```\n\n## Configuration\n\n[Get your free AxionQuant API key](https://axionquant.com/dashboard/api-keys)\n\n### Claude Desktop\n\nAdd the following to your Claude Desktop MCP config file to connect AxionQuant's financial data tools:\n\n**MacOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`  \n**Windows**: `%APPDATA%/Claude/claude_desktop_config.json`\n\n```json\n{\n  \"mcpServers\": {\n    \"axion-financial-data\": {\n      \"command\": \"node\",\n      \"args\": [\"/absolute/path/to/node_modules/@axionquant/mcp/index.js\"],\n      \"env\": {\n        \"API_KEY\": \"your_api_key_here\"\n      }\n    }\n  }\n}\n```\n\n### Other MCP Clients\n\nThe server uses stdio transport and is compatible with any MCP client. Set the `API_KEY` environment variable and configure according to your client's documentation.\n\n## Available Tools\n\n### Stocks\n\nReal-time quotes and historical price data for US and global equities.\n\n| Tool | Description |\n|------|-------------|\n| `stocks_tickers` | List stock tickers, optionally filtered by country or exchange |\n| `stocks_quote` | Get current quote/details for a stock ticker |\n| `stocks_prices` | Get historical price data (supports `from`, `to`, `frame`) |\n\n### Crypto\n\nCryptocurrency pricing and market data.\n\n| Tool | Description |\n|------|-------------|\n| `crypto_tickers` | List cryptocurrency tickers, optionally filtered by type |\n| `crypto_quote` | Get current details for a cryptocurrency |\n| `crypto_prices` | Get historical price data |\n\n### Forex\n\nForeign exchange rates and currency pair data.\n\n| Tool | Description |\n|------|-------------|\n| `forex_tickers` | List forex pairs, optionally filtered by country or exchange |\n| `forex_quote` | Get current details for a forex pair |\n| `forex_prices` | Get historical price data |\n\n### Futures\n\nFutures contract pricing and market data.\n\n| Tool | Description |\n|------|-------------|\n| `futures_tickers` | List futures tickers, optionally filtered by exchange |\n| `futures_quote` | Get current details for a futures contract |\n| `futures_prices` | Get historical price data |\n\n### Indices\n\nMarket index pricing and composition data.\n\n| Tool | Description |\n|------|-------------|\n| `indices_tickers` | List index tickers, optionally filtered by exchange |\n| `indices_quote` | Get current details for an index |\n| `indices_prices` | Get historical price data |\n\n### ETFs\n\nETF holdings, exposure, and fund metrics.\n\n| Tool | Description |\n|------|-------------|\n| `etf_fund` | Get ETF fund information including ratings and metrics |\n| `etf_holdings` | Get top holdings with weights, shares, and market value |\n| `etf_holdings_all` | Get all ETF holdings with weights and last updated date |\n| `etf_exposure` | Find which ETFs hold a specific stock ticker |\n\n### Economics (FRED)\n\nMacroeconomic datasets and calendar events sourced from FRED.\n\n| Tool | Description |\n|------|-------------|\n| `econ_search` | Search for economic datasets |\n| `econ_dataset` | Get a time series by dataset ID |\n| `econ_calendar` | Get economic calendar events (filterable by country, currency, category, importance) |\n\n### News\n\nMarket news headlines by company, country, or category.\n\n| Tool | Description |\n|------|-------------|\n| `news_general` | Get general market news headlines |\n| `news_ticker` | Get news for a specific company |\n| `news_country` | Get news for a specific country |\n| `news_category` | Get news by category (e.g. `business`, `technology`) |\n\n### Sentiment\n\nSocial, news, and analyst sentiment scoring.\n\n| Tool | Description |\n|------|-------------|\n| `sentiment_all` | Get combined sentiment (social + news + analyst) for a ticker |\n| `sentiment_social` | Get social media sentiment |\n| `sentiment_news` | Get news sentiment |\n| `sentiment_analyst` | Get analyst/AI sentiment |\n\n### Profiles\n\nCompany profiles, analyst recommendations, and key statistics.\n\n| Tool | Description |\n|------|-------------|\n| `profiles_profile` | Get full asset profile |\n| `profiles_recommendation` | Get analyst recommendation trend |\n| `profiles_statistics` | Get key statistics |\n| `profiles_summary` | Get summary detail |\n| `profiles_calendar` | Get earnings and dividend calendar events |\n| `profiles_info` | Get company info / summary profile |\n\n### Earnings\n\nEarnings history, trends, and quarterly reports.\n\n| Tool | Description |\n|------|-------------|\n| `earnings_history` | Get historical earnings |\n| `earnings_trend` | Get earnings trend |\n| `earnings_index` | Get index trend |\n| `earnings_report` | Get earnings report for a specific year and quarter |\n\n### SEC Filings\n\nSearch and retrieve SEC filings by form type and date.\n\n| Tool | Description |\n|------|-------------|\n| `filings_recent` | Get recent filings, optionally filtered by form type |\n| `filings_forms` | Get filings by form type (e.g. `10-K`, `8-K`) |\n| `filings_list_forms` | List all available SEC form types |\n| `filings_search` | Search filings by year/quarter |\n\n### Financials\n\nFinancial statements, historical fundamentals, valuation ratios, and DCF analysis.\n\n| Tool | Description |\n|------|-------------|\n| `financials_revenue` | Historical revenue |\n| `financials_net_income` | Historical net income |\n| `financials_total_assets` | Historical total assets |\n| `financials_total_liabilities` | Historical total liabilities |\n| `financials_stockholders_equity` | Historical stockholders equity |\n| `financials_current_assets` | Historical current assets |\n| `financials_current_liabilities` | Historical current liabilities |\n| `financials_operating_cash_flow` | Historical operating cash flow |\n| `financials_capital_expenditures` | Historical capital expenditures |\n| `financials_free_cash_flow` | Historical free cash flow |\n| `financials_shares_outstanding_basic` | Historical basic shares outstanding |\n| `financials_shares_outstanding_diluted` | Historical diluted shares outstanding |\n| `financials_metrics` | Calculated financial metrics |\n| `financials_snapshot` | Snapshot of key financial data |\n| `financials_eps` | TTM earnings per share |\n| `financials_pe` | Price-to-earnings ratio |\n| `financials_market_cap` | Market capitalization |\n| `financials_roe` | Return on equity |\n| `financials_enterprise_value` | Enterprise value |\n| `financials_ebitda` | TTM EBITDA |\n| `financials_debt_to_equity` | Debt-to-equity ratio |\n| `financials_dcf_value` | DCF valuation (enterprise value, fair price, margin of safety, recommendation) |\n| `financials_dcf_rate` | Discount rate / WACC calculation (cost of equity, cost of debt, capital structure) |\n\n### Insiders & Ownership\n\nInsider trading activity and institutional ownership data.\n\n| Tool | Description |\n|------|-------------|\n| `insiders_funds` | Fund ownership data |\n| `insiders_individuals` | Insider holders (individuals) |\n| `insiders_institutions` | Institutional ownership |\n| `insiders_ownership` | Major holders breakdown |\n| `insiders_activity` | Net share purchase activity |\n| `insiders_transactions` | Insider transactions |\n\n### ESG\n\nEnvironmental, social, and governance scoring.\n\n| Tool | Description |\n|------|-------------|\n| `esg_data` | Get ESG (Environmental, Social, Governance) scores for a ticker |\n\n### Supply Chain\n\nCompany customer, supplier, and peer relationships.\n\n| Tool | Description |\n|------|-------------|\n| `supply_chain_customers` | Get a company's customers |\n| `supply_chain_peers` | Get peer companies / competitors |\n| `supply_chain_suppliers` | Get a company's suppliers |\n\n### Credit\n\nCredit ratings from the S&P database.\n\n| Tool | Description |\n|------|-------------|\n| `credit_search` | Search the S&P credit rating database by organization name |\n| `credit_ratings` | Get credit ratings for a specific organization by ID |\n\n### Web Traffic\n\nWebsite traffic estimates by company.\n\n| Tool | Description |\n|------|-------------|\n| `webtraffic_traffic` | Get website traffic data for a company |\n\n## Example Queries\n\nOnce connected to an LLM like Claude, you can ask natural language questions such as:\n\n- \"What are the NASDAQ-listed stock tickers?\"\n- \"Get Bitcoin's price history for the last 30 days\"\n- \"What are SPY's top 10 holdings?\"\n- \"Show me Apple's credit rating\"\n- \"What's Tesla's ESG score?\"\n- \"Who are the main suppliers for AAPL?\"\n- \"Get the EUR/USD exchange rate history\"\n- \"What SEC filings has Microsoft made this year?\"\n- \"Show me NVDA's free cash flow over the last 8 quarters\"\n- \"What's the economic calendar for next week?\"\n\n## Architecture\n\n```\nLLM (Claude, etc.) <--> MCP Server <--> Axion REST API\n```\n\n## Troubleshooting\n\n**Tools not appearing in your LLM client** - Restart the client and verify the config file path is correct and absolute.\n\n**API requests failing** - Check that `API_KEY` is set correctly in your environment or config. Review server logs for detailed error messages.\n\n**Server won't start** - Ensure Node.js v18+ is installed and the package is installed via `npm i @axionquant/mcp`.\n\n## FAQ\n\n**What is the AxionQuant MCP server?**\nIt's a Model Context Protocol server that connects LLMs like Claude to the AxionQuant financial data API, so you can ask natural-language questions about stocks, crypto, earnings, SEC filings, and more instead of writing API calls by hand.\n\n**Does the AxionQuant MCP server work with Claude Desktop?**\nYes - add it to your Claude Desktop config file as shown above. It also works with any client that supports the Model Context Protocol over stdio transport.\n\n**Is there a free AxionQuant API key?**\nYes - you can [get a free API key](https://axionquant.com/dashboard/api-keys) from the AxionQuant dashboard.\n\n**What financial data can I query through MCP?**\nStocks, crypto, forex, futures, indices, and ETFs, plus financial statements, earnings, SEC filings, insider trading, sentiment, news, economic (FRED) data, credit ratings, ESG scores, supply chain relationships, and web traffic estimates - over 100 tools in total.\n\n## Get Started\n\nFor full API documentation, visit the [AxionQuant docs](https://axionquant.com/docs). For support or to obtain an API key, visit [axionquant.com](https://axionquant.com).\n\n## License\n\nMIT\n",
  "bytes": 12050,
  "sha": "91e66c6cda58656ec31fcf7202ba1af2ba3b5c8606f1ff4c0b96bad50824d58b",
  "repo_slug": "axionquant/mcp-server",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_axionquant_axionquant_21abe703/readme"
}