# cvm-mcp

An MCP server for the CVM open-data repository (dados.cvm.gov.br), giving MCP clients one interface to Brazilian financial statements, corporate filings, fund data, insider trading and more.

- **Ecosystem:** Python (PyPI)
- **Page URL:** https://www.msperlin.com/code/python/cvm-mcp
- **GitHub:** https://github.com/msperlin/cvm-mcp
- **PyPI:** https://pypi.org/project/cvm-mcp/
- **Monthly downloads:** 370
- **All-time downloads:** 370
- **GitHub stars:** 6
- **Last push:** 2026-11-14

## Installation

```bash
uvx cvm-mcp
```

```bash
pip install cvm-mcp
```

## Quickstart

```bash
# Run directly with uvx (recommended for MCP clients)
uvx cvm-mcp

# Or install from PyPI
pip install cvm-mcp
```

## MCP Client Configuration

```json
{
  "mcpServers": {
    "cvm": {
      "command": "uvx",
      "args": [
        "cvm-mcp"
      ]
    }
  }
}
```

## Related Datasets

- [GetDFPData2](https://www.msperlin.com/data/getdfpdata2) (DOI: 10.7910/DVN/7VVX4J)
- [GetFREData](https://www.msperlin.com/data/getfredata) (DOI: 10.7910/DVN/QIMUNZ)

## Related Publications

- 2019 — [Accessing Financial Reports and Corporate Events with GetDFPData](https://www.msperlin.com/publications/2019-rbfin-accessing-financial-repor)

## Citation

```bibtex
@manual{perlin_cvm_mcp,
  author = {Perlin, Marcelo S.},
  title = {cvm-mcp: An MCP server for the CVM open-data repository (dados.cvm.gov.br), giving MCP clients one interface to Brazilian financial statements, corporate filings, fund data, insider trading and more.},
  year = {2026},
  note = {Python Model Context Protocol (MCP) server},
  url = {https://github.com/msperlin/cvm-mcp}
}
```
