# ACA PoC MCP Tools Server

Financial audit and ledger query tools exposed via Model Context Protocol (MCP).

## Overview

This MCP server provides AI agents with tools to:
- **Generate Audit Reports**: Create compliance, risk, and transaction summary reports
- **Query Financial Ledger**: Access transaction data, balances, and summaries from an in-memory SQLite database

## Features

- 🔒 **Regulatory-grade audit reporting** (SOC-2 Type II, ISO-27001 compliant)
- 💾 **In-memory SQLite database** with 1000 sample transactions
- 🔌 **MCP Protocol** for seamless AI agent integration
- 🐳 **Docker support** for easy deployment

## Tools

### 1. generate_audit_report
Generate comprehensive audit reports for financial data.

**Parameters:**
- `report_type`: Type of report (`compliance`, `risk`, `transaction`)
- `date_range` (optional): Date range filter with `start_date` and `end_date`
- `format` (optional): Output format (`json` or `csv`)

**Example:**
```json
{
  "report_type": "compliance",
  "date_range": {
    "start_date": "2026-01-01",
    "end_date": "2026-07-28"
  },
  "format": "json"
}
```

### 2. query_ledger
Query financial ledger data from the in-memory database.

**Parameters:**
- `query_type`: Type of query (`transactions`, `balance`, `summary`)
- `date_range` (optional): Date range filter
- `limit` (optional): Maximum number of results (default: 100)

**Example:**
```json
{
  "query_type": "transactions",
  "limit": 50
}
```

## Installation

### Using Docker

```bash
docker build -t aca-mcp-tools .
docker run -p 8080:8080 aca-mcp-tools
```

### Local Development

```bash
# Install dependencies
pip install -r requirements.txt

# Run the server
python main.py
```

## MCP Configuration

Add to your MCP client configuration:

```json
{
  "mcpServers": {
    "aca-financial-tools": {
      "url": "http://localhost:8080",
      "transport": "streamable-http"
    }
  }
}
```

## Project Structure

```
mcp_tools/
├── main.py                 # MCP server implementation
├── requirements.txt        # Python dependencies
├── Dockerfile             # Container configuration
├── tools/
│   ├── generate_audit_report.py  # Audit report generator
│   └── query_ledger.py           # Ledger query tool
└── README.md
```

## Security & Compliance

- **Certified**: SCB-2026-04 (Security Compliance Board)
- **Standards**: SOC-2 Type II, ISO-27001
- **Phase**: 9 (Production-ready)
- **Owner**: ACA PoC Team

## License

MIT License - See LICENSE file for details

## Contributing

This is a proof-of-concept project for demonstrating AGNTCY Directory capabilities.

## Contact

ACA PoC Team - aca-poc@dell.com