aicpa-audit-data-api

GenAICPA/aicpa-audit-data-api

3.2

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

  1. Clone the repository

    git clone https://github.com/GenAICPA/aicpa-audit-data-api.git
    cd aicpa-audit-data-api
    
  2. Start the API Server

    cd api-server
    cp .env.example .env
    npm install
    npm start
    
  3. Start the MCP Server (in a new terminal)

    cd mcp-server
    cp .env.example .env
    npm install
    npm start
    
  4. Access the Demo Open http://localhost:3000 in your browser

Docker Setup

docker-compose up -d

๐Ÿ“š Documentation

๐Ÿ”ง API Endpoints

EndpointDescriptionParameters
/api/v1/general-ledger/trial-balanceTrial balance dataentityId, endDate
/api/v1/general-ledger/chart-of-accountsChart of accountsentityId, level
/api/v1/general-ledger/detailGL transactionsentityId, startDate, endDate
/api/v1/subledgers/accounts-receivableAR aging dataentityId, asOfDate
/api/v1/subledgers/accounts-payableAP detailsentityId, 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

  1. Fork the repository
  2. Create a feature branch (git checkout -b feature/amazing-feature)
  3. Commit changes (git commit -m 'Add amazing feature')
  4. Push to branch (git push origin feature/amazing-feature)
  5. 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!