UnHideA Research MCP Server
by lijiumixin
README.md
# UnHideA Research MCP Server
[](https://registry.modelcontextprotocol.io/v0.1/servers/io.github.lijiumixin%2Funhidea-research-mcp/versions/latest)
[](https://unhidea.com/en/mcp)
[](https://unhidea.com/en/mcp)
[](#available-tools)
[](LICENSE)
**Remote Streamable HTTP & OAuth 2.0 Model Context Protocol (MCP) server for Wall Street sell-side equity research, cross-institution company packs, sourced rating/target-price histories, and point-in-time research replay.**
- **Official MCP Registry ID:** `io.github.lijiumixin/unhidea-research-mcp` (`v1.0.0`)
- **Remote Endpoint:** `https://mcp.unhidea.com/mcp`
- **Transport:** Streamable HTTP
- **Authentication:** OAuth 2.0 Dynamic Client Registration (`research:read`, `research:write`) or personal Bearer key (`Authorization: Bearer <key>`)
- **Documentation & Key Setup:** https://unhidea.com/en/mcp (中文说明:https://unhidea.com/zh-hans/mcp)
- **Live Company & Bank Hubs:** [Companies](https://unhidea.com/en/companies) · [Institutions](https://unhidea.com/en/institutions) · [Research Library](https://unhidea.com/en/library)
- **Companion Open Dataset (MIT):** [wall-street-research-entities](https://github.com/lijiumixin/wall-street-research-entities) (405 global companies + 73 sell-side institutions across 11 languages)
- **Updates on X:** https://x.com/UnHideA
---
## Why UnHideA Research MCP?
Most financial MCP servers only expose raw price quotes or SEC filings. **UnHideA Research MCP** focuses on **institutional sell-side equity research** (Goldman Sachs, Morgan Stanley, J.P. Morgan, Citi, Bank of America, Bernstein, Evercore ISI, HSBC, Nomura, Barclays, Deutsche Bank, and more) with strict grounding and point-in-time hygiene:
- **Cross-bank comparison packs** (`research_pack`) to see where Wall Street desks agree or split on one company
- **Sourced ratings, price targets, and forecast verification** (`research_metric_history`, `research_forecast_outcomes`) matched by period, currency, unit, and basis
- **Counter-evidence retrieval** (`evidence_candidates`) to pull verbatim quotes supporting *or challenging* an investment thesis
- **Point-in-time snapshots** (`replay_research`) accumulated since initial indexing for clean historical replay without look-ahead bias
- **Deduplicated bilingual coverage** across Chinese originals and verified English translations, with direct links to full web briefs and authenticated on-site PDF readers
---
## Quick Start
### Option 1: OAuth 2.0 (Clients Supporting Dynamic Client Registration)
Add the remote server URL directly in your MCP client (e.g., Claude, ChatGPT, or OAuth-capable MCP hosts):
```text
https://mcp.unhidea.com/mcp
```
OAuth metadata discovery is served automatically at:
`https://mcp.unhidea.com/.well-known/oauth-protected-resource`
Supported scopes:
- `research:read` — search, fetch, packs, clusters, evidence, metric history, replay, and read watchlist
- `research:write` — update persistent watchlist and submit topic requests
### Option 2: Bearer Key (Cursor, Antigravity, Windsurf, Custom Agents)
1. Sign in and generate a personal MCP key at https://unhidea.com/en/mcp (or https://unhidea.com/zh-hans/mcp).
2. Add the server to your `mcp_config.json` / `.cursor/mcp.json`:
```json
{
"mcpServers": {
"unhidea-research": {
"url": "https://mcp.unhidea.com/mcp",
"headers": {
"Authorization": "Bearer <YOUR_UNHIDEA_MCP_KEY>"
}
}
}
}
```
---
## Available Tools (14)
| Tool | Purpose |
| --- | --- |
| `search` | Find published UnHideA research by title, institution, ticker, topic, keyword, or date (deduplicated per original report, with on-site PDF reader links where archived). |
| `fetch` | Retrieve the public synopsis, verbatim section excerpts, and archived PDF reader URL for a research ID. |
| `research_pack` | Pull latest coverage on a tagged company, cross-institution views, and prior reports from the latest covering desk. |
| `research_updates` | Track new research across multiple tickers or topics over a rolling window (default 7 days). |
| `coverage_map` | Map a topic or filtered query by co-occurring themes, covered companies, institutions, cited examples, and a reading shortlist. |
| `event_clusters` | Identify shared-event coverage where multiple banks published on the same company/catalyst on the same report date. |
| `evidence_candidates` | Retrieve verbatim public excerpts matching a claim—with optional `counter_query` to surface challenging evidence. |
| `research_metric_history` | Return sourced ratings, price targets, and financial forecasts over time with period, currency, unit, and basis metadata. |
| `research_forecast_outcomes` | Match historical forecast claims against subsequent reported disclosures (flagging unverified items honestly). |
| `replay_research` | Query point-in-time historical index snapshots accumulated since initial publication. |
| `get_watchlist` | Read your saved companies and research topics watchlist. |
| `set_watchlist` | Save or update your tracked companies and research topics (`research:write`). |
| `watchlist_updates` | Poll recent research updates for every company and topic on your watchlist. |
| `submit_topic_request` | Submit a new company, sector, or theme coverage request (`research:write`). |
---
## Example Prompts
- *"Use `research_pack` for Microsoft and summarize where Goldman Sachs, HSBC, Citi, Nomura, and Bank of America disagree on FY27 Azure growth vs. capex."*
- *"Run `evidence_candidates` on Apple with `query: gross margin memory costs` and `counter_query: App Store revenue acceleration`."*
- *"Check `research_metric_history` for Meta over the last quarter and list every sourced price target change."*
- *"Use `event_clusters` to find all multi-bank reactions published this week on semiconductor earnings."*
---
## Support & License
- Website: https://unhidea.com/en/
- Support: help@unhidea.com
- X: https://x.com/UnHideA
- Documentation & manifest license: [MIT](LICENSE)
This server cannot be deployed
Maintenance
ActivityMaintained
ResponsivenessNo recent community issues