ACA PoC MCP Tools Server

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 - [email protected]