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:

{
  "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:

{
  "query_type": "transactions",
  "limit": 50
}

Installation

Using Docker

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

Local Development

# Install dependencies
pip install -r requirements.txt

# Run the server
python main.py

MCP Configuration

Add to your MCP client configuration:

{
  "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