open-index/open-npm huggingface dataset:
npm package: @shawyan/mcp-financials-server
Description: An MCP server that provides computed financial metrics, ratios, trend analysis, and company comparisons from SEC XBRL data.
Latest version: 0.1.3

# Dolph Financials Server (MCP)

An MCP server that provides computed financial metrics, ratios, trend analysis, and company comparisons from SEC XBRL data.

## Tools

### `get_financial_statements`
Normalized financial statement data (income, balance sheet, cash flow) across periods.

**Input:**
```json
{ "ticker": "AAPL", "statement": "income", "period": "annual", "limit": 5 }
```

### `calculate_ratios`
Compute financial ratios with formulas and component values for verification.

**Input:**
```json
{ "ticker": "AAPL", "ratios": ["roe", "de", "gross_margin"] }
```

**Output includes:**
```json
{
  "name": "roe",
  "display_name": "Return on Equity",
  "value": 1.7145,
  "formula": "net_income / stockholders_equity",
  "components": { "net_income": 96995000000, "stockholders_equity": 56572000000 }
}
```

### `get_trend_analysis`
YoY growth rates, CAGR, and anomaly detection for financial metrics.

**Input:**
```json
{ "ticker": "AAPL", "metrics": ["revenue", "net_income"], "periods": 10 }
```

### `compare_companies`
Side-by-side comparison of metrics across multiple tickers with rankings.

**Input:**
```json
{ "tickers": ["AAPL", "MSFT", "GOOGL"], "metrics": ["revenue", "net_income", "operating_margin"] }
```

## Setup

```bash
pnpm install
pnpm build
```

### Claude Desktop Configuration

```json
{
  "mcpServers": {
    "dolph-financials": {
      "command": "node",
      "args": ["/path/to/dolph/packages/mcp-financials-server/dist/index.js"],
      "env": {
        "DOLPH_SEC_USER_AGENT": "YourName your@email.com"
      }
    }
  }
}
```
npm package: @shawyan/mcp-sec-server
Description: An MCP server that gives any LLM structured access to SEC EDGAR data — filings, financial facts, and full-text search.
Latest version: 0.1.3

# Dolph SEC Server (MCP)

An MCP server that gives any LLM structured access to SEC EDGAR data — filings, financial facts, and full-text search.

## Tools

### `get_company_filings`
Retrieve recent SEC filings (10-K, 10-Q, 8-K, DEF 14A) for a stock ticker.

**Input:**
```json
{ "ticker": "AAPL", "filing_type": "10-K", "limit": 5 }
```

**Output:** Array of `{ filing_type, date_filed, accession_number, primary_document_url, description }`

### `get_filing_content`
Fetch and parse the HTML content of a specific filing. Extracts named sections (Business, Risk Factors, MD&A, etc.).

**Input:**
```json
{ "accession_number": "0000320193-24-000123", "document_url": "https://..." }
```

### `get_company_facts`
Retrieve structured XBRL financial data (revenue, net income, EPS, etc.) across reporting periods.

**Input:**
```json
{ "ticker": "AAPL" }
```

### `search_filings`
Full-text search across SEC filings by keyword.

**Input:**
```json
{ "query": "AI strategy", "ticker": "MSFT", "date_from": "2023-01-01" }
```

## Setup

```bash
pnpm install
pnpm build
```

### Claude Desktop Configuration

Add to your `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "dolph-sec": {
      "command": "node",
      "args": ["/path/to/dolph/packages/mcp-sec-server/dist/index.js"],
      "env": {
        "DOLPH_SEC_USER_AGENT": "YourName your@email.com"
      }
    }
  }
}
```

## Notes

- **Rate limiting:** Max 10 requests/second to SEC EDGAR (enforced automatically)
- **Caching:** Responses cached in `~/.dolph/cache/` (24h for listings, 7d for content)
- **User-Agent:** SEC requires identifying User-Agent header — set via `DOLPH_SEC_USER_AGENT`