Lician MCP Server

Model Context Protocol (MCP) server for the Lician Financial Data API. Enables AI agents like Claude, GPT, and Gemini to access real-time stock prices, financial statements, insider trades, and institutional holdings.

Features

• 17 Financial Data Tools for comprehensive market analysis
• 141,000+ Companies across US and European markets
• Real-time Data including prices, insider trades, and 13F filings
• No API Key Required for basic access (100 requests/day)
• Works with Claude Desktop, OpenAI Agents SDK, and any MCP-compatible client

Installation

For Claude Desktop

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "lician": {
      "command": "npx",
      "args": ["@lician/mcp-server"],
      "env": {
        "LICIAN_API_KEY": "your-api-key-optional"
      }
    }
  }
}

Global Installation

npm install -g @lician/mcp-server

Then run:

lician-mcp

From Source

git clone https://github.com/lician/mcp-server
cd mcp-server
npm install
npm run build
npm start

Available Tools

Stock Prices

| Tool | Description | |------|-------------| | get_stock_price | Current price, daily change, volume, market cap | | get_historical_prices | Historical OHLCV data for charts and analysis |

Financial Statements

| Tool | Description | |------|-------------| | get_income_statement | Revenue, gross profit, operating income, net income, EPS | | get_balance_sheet | Assets, liabilities, equity, cash, debt | | get_cash_flow | Operating, investing, financing cash flows, FCF | | get_financial_metrics | P/E, P/B, ROE, ROA, margins, dividend yield |

Insider Trading

| Tool | Description | |------|-------------| | get_insider_trades | SEC Form 4 buys/sells by executives and directors |

Institutional Holdings

| Tool | Description | |------|-------------| | get_institutional_holders | 13F institutional ownership for a stock | | get_investor_portfolio | All holdings for a specific fund/investor |

Analyst Data

| Tool | Description | |------|-------------| | get_analyst_ratings | Buy/hold/sell ratings and price targets | | get_analyst_estimates | EPS and revenue estimates for upcoming quarters |

Company & News

| Tool | Description | |------|-------------| | get_company_info | Sector, industry, description, CEO, employees | | get_stock_news | Recent news articles and headlines | | get_sec_filings | 10-K, 10-Q, 8-K SEC filings |

Crypto & Macro

| Tool | Description | |------|-------------| | get_crypto_prices | Bitcoin, Ethereum, and major crypto prices | | get_interest_rates | Treasury yields and fed funds rate |

Usage Examples

Once installed, you can ask Claude:

"What's Apple's current stock price and how has it performed?"

Claude will use get_stock_price to fetch:

{
  "snapshot": {
    "ticker": "AAPL",
    "price": 185.92,
    "day_change": 2.34,
    "day_change_percent": 1.27,
    "volume": 45234567,
    "market_cap": 2890000000000
  }
}

"Show me insider trading activity at Tesla"

Claude will use get_insider_trades:

{
  "insider_trades": [
    {
      "ticker": "TSLA",
      "insider_name": "Elon Musk",
      "insider_title": "CEO",
      "transaction_type": "S-Sale",
      "shares": 100000,
      "price": 245.50,
      "value": 24550000,
      "filing_date": "2026-01-15"
    }
  ]
}

"What stocks does Berkshire Hathaway own?"

Claude will use get_investor_portfolio:

{
  "investor": "Berkshire Hathaway",
  "total_value": 350000000000,
  "holdings": [
    {
      "ticker": "AAPL",
      "company_name": "Apple Inc.",
      "shares": 905000000,
      "value": 168000000000,
      "percent_of_portfolio": 48.0
    }
  ]
}

Authentication

Free Tier (No API Key)

• 100 requests per day
• US market data only
• End-of-day prices

With API Key

Set your API key as an environment variable:

export LICIAN_API_KEY=your-api-key

Or in Claude Desktop config:

{
  "mcpServers": {
    "lician": {
      "command": "npx",
      "args": ["@lician/mcp-server"],
      "env": {
        "LICIAN_API_KEY": "your-api-key"
      }
    }
  }
}

API Tiers

| Tier | Price | Requests/Day | Features | |------|-------|--------------|----------| | Free | $0 | 100 | US data, EOD prices | | Basic | $29/mo | 10,000 | US + EU, real-time | | Pro | $99/mo | 100,000 | All data, 13F, SEC |

Get an API key at lician.com/developers/signup

Data Coverage

• US Companies: 5,345 tickers (NYSE, NASDAQ, AMEX)
• EU Companies: 106,975 companies (UK, Norway, Sweden, Denmark, Finland)
• Financial Records: 839,000+
• Data Types: Prices, financials, insider trades, 13F, SEC filings, analyst ratings

API Reference

For complete API documentation, see:

• API Docs
• OpenAPI Spec
• LLMs Context

Development

# Install dependencies
npm install

# Run in development mode
npm run dev

# Build for production
npm run build

# Run production build
npm start

License

MIT

Support

• Email: [email protected]
• Documentation: lician.com/developers
• Issues: GitHub Issues

Built by Lician - AI-Powered Financial Data Platform