GenAICPA/aicpa-audit-data-api
If you are the rightful owner of aicpa-audit-data-api and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.
The Model Context Protocol (MCP) server is designed to facilitate seamless interaction between AI assistants and audit data, ensuring compliance with AICPA Audit Data Standards.
AICPA Audit Data API
A comprehensive implementation of the AICPA Audit Data Standards (2012-2015) with Model Context Protocol (MCP) server integration for AI assistants.
๐ Features
- Standards Compliant: Implements AICPA-ADS specifications
- AI-Ready: Full MCP integration for AI assistants like Claude
- Production-Ready: Comprehensive error handling and validation
- Interactive Demo: Web interface for testing API endpoints
- Docker Support: Easy containerized deployment
๐ Quick Start
Prerequisites
- Node.js 18+
- npm or yarn
Installation
-
Clone the repository
git clone https://github.com/GenAICPA/aicpa-audit-data-api.git cd aicpa-audit-data-api
-
Start the API Server
cd api-server cp .env.example .env npm install npm start
-
Start the MCP Server (in a new terminal)
cd mcp-server cp .env.example .env npm install npm start
-
Access the Demo Open http://localhost:3000 in your browser
Docker Setup
docker-compose up -d
๐ Documentation
๐ง API Endpoints
Endpoint | Description | Parameters |
---|---|---|
/api/v1/general-ledger/trial-balance | Trial balance data | entityId, endDate |
/api/v1/general-ledger/chart-of-accounts | Chart of accounts | entityId, level |
/api/v1/general-ledger/detail | GL transactions | entityId, startDate, endDate |
/api/v1/subledgers/accounts-receivable | AR aging data | entityId, asOfDate |
/api/v1/subledgers/accounts-payable | AP details | entityId, asOfDate |
๐ค MCP Integration
This project includes a Model Context Protocol server that enables AI assistants to interact with audit data using natural language:
// Example AI interactions
"What's the current cash position for DEMO-CORP-001?"
"Calculate liquidity ratios as of December 31, 2024"
"Show me all revenue transactions from Q4"
๐ Standards Compliance
- AICPA-ADS-GL-v1.0: General Ledger Standard
- AICPA-ADS-AR-v1.0: Accounts Receivable Standard
- AICPA-ADS-AP-v1.0: Accounts Payable Standard
- XBRL-JSON: Data exchange format
- ISO-8601: Date formatting
๐งช Testing
# API Server tests
cd api-server && npm test
# MCP Server tests
cd mcp-server && npm test
๐ค Contributing
- Fork the repository
- Create a feature branch (
git checkout -b feature/amazing-feature
) - Commit changes (
git commit -m 'Add amazing feature'
) - Push to branch (
git push origin feature/amazing-feature
) - Open a Pull Request
๐ License
This project is licensed under the MIT License - see the file for details.
๐ Acknowledgments
- AICPA Audit Data Standards Working Group
- Model Context Protocol contributors
- Open source community
๐ Support
- Create an Issue
- Read the
- Check
โญ Star this repo if you find it helpful!