# DataSinking

Connects an AI agent to full-text financial reports from the US, UK and Asia in Markdown. Useful for company research and RAG queries by report section.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 22
- Author: heubme2020
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/heubme2020/datasinking
- Updated: 2026-10-19
- HTML: https://affpapa.org/en/nevibecode/mcp/datasinking

## What it does

DataSinking gives an agent access to annual, semi-annual and quarterly financial reports from the US, UK, China, Japan, Korea and Taiwan. The service returns structured Markdown with headings, tables and YAML frontmatter. Queries can target an FMP-style symbol, exchange, reporting period or a section such as MD&A or risk disclosures.

The MCP server exposes six tools for browsing exchanges, stocks, reports and sections, plus retrieving a full report or one section. Fetching a section keeps RAG context smaller while retaining links from figures to their source disclosure. An API key is required.

For a local setup, use Node 18+ with `npx -y datasinking-mcp` or Python 3.8+ with `datasinking[mcp]`. A hosted endpoint is also available at `https://api.datasink.ing/mcp`, so no local server package is needed for that route.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://api.datasink.ing/mcp`
- Environment variables: `DATASINK_API_KEY` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

1. **Platform CLI**
```bash
claude mcp add datasinking -e DATASINK_API_KEY=<DATASINK_API_KEY> -- npx -y datasinking-mcp
```
Replace <…> with your own values

2. **Platform CLI: remote server**
```bash
claude mcp add --transport http datasinking https://api.datasink.ing/mcp
```

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add datasinking --url https://api.datasink.ing/mcp
```

2. **Platform CLI**
```bash
codex mcp add datasinking --env DATASINK_API_KEY=<DATASINK_API_KEY> -- npx -y datasinking-mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "datasinking": {
            "url": "https://api.datasink.ing/mcp"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "datasinking": {
            "command": "npx",
            "args": [
                "-y",
                "datasinking-mcp"
            ],
            "env": {
                "DATASINK_API_KEY": "<DATASINK_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "datasinking": {
            "type": "http",
            "url": "https://api.datasink.ing/mcp"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "datasinking": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "datasinking-mcp"
            ],
            "env": {
                "DATASINK_API_KEY": "<DATASINK_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http datasinking https://api.datasink.ing/mcp
```

2. **Platform CLI**
```bash
gemini mcp add -e DATASINK_API_KEY=<DATASINK_API_KEY> datasinking npx -y datasinking-mcp
```
Replace <…> with your own values

## When to use it
- find company reports by FMP-style symbol
- retrieve a financial filing as Markdown
- pull only the MD&A or risk section
- prepare report text for RAG ingestion
- trace a figure to its source disclosure

## Example prompts
- Find the quarterly reports for `600519.SS` and list their reporting periods.
- Fetch the risk section for `AAPL` from the requested reporting period.
- List available exchanges, then show reports for a selected company.

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 386989
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33918
- [World Monitor](https://affpapa.org/en/nevibecode/mcp/world-monitor.md) — MCP server · ★ 89408
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81115
- [Front-End Checklist](https://affpapa.org/en/nevibecode/mcp/front-end-checklist.md) — MCP server · ★ 74559
- [Scrapling MCP Server](https://affpapa.org/en/nevibecode/mcp/scrapling-mcp-server.md) — MCP server · ★ 89433

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md