IIA-MCP Server
References a GitHub repository for IIA resources through an environment variable (IIA_GITHUB_REPO), allowing the server to potentially sync or version the structured IIA documentation.
Converts IIA resources from HTML to markdown format with proper frontmatter, organizing professional standards and guidance documents for AI consumption.
Required as a runtime environment for the MCP server, listed as a prerequisite (v18+) for running the server that provides access to IIA resources.
Utilized for package management and running scripts to build, scrape content, and start the MCP server providing IIA resources.
Used as the implementation language for the MCP server components, including the scraper and server logic that delivers IIA content.
Parses YAML frontmatter for rich metadata in IIA content, enabling advanced features like relevance scoring and standard number detection.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@IIA-MCP Server validate compliance for cybersecurity audit procedures"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
IIA-MCP Server
A Model Context Protocol (MCP) server that provides AI assistants with access to Institute of Internal Auditors (IIA) professional standards and resources.
Overview
This project creates an MCP server that scrapes IIA resources and formats them as markdown files for easy consumption by AI agents. The server provides comprehensive access to:
IIA Professional Standards (1000 and 2000 series)
Implementation Guidance and IPPF framework
Specialized Topics (cybersecurity, ESG, risk assessment, etc.)
Glossary and Templates
Recent Updates and changes
Related MCP server: Integrator MCP Server
Architecture
Components
Scraper (
scraper.ts) - Web scraping tool that downloads IIA resourcesMCP Server (
iia_mcp_server.ts) - Serves scraped content via Model Context ProtocolStructured Output - Well-organized markdown files following IIA documentation patterns
Directory Structure
Following the structure defined in Structure.txt:
iia-resources/
├── standards/
│ ├── 1000-series/ # Independence and Objectivity
│ ├── 2000-series/ # Performance Standards
│ └── index.md # Standards overview
├── guidance/
│ ├── ippf-framework.md
│ ├── coso-integration.md
│ ├── ethics-code.md
│ └── implementation/ # Detailed guidance
├── topics/ # Specialized audit topics
├── glossary/ # Definitions and acronyms
├── templates/ # Audit templates and tools
└── updates/ # Recent changes and updatesGetting Started
Prerequisites
Node.js (v18+)
TypeScript
npm
Installation
# Install dependencies
npm install
# Build the project
npm run buildUsage
1. Scrape IIA Resources
# Run the scraper to download and format IIA content
npm run scrapeThis will:
Create the
iia-resources/directory structureDownload IIA content from their website
Convert HTML to markdown with proper frontmatter
Organize files according to the standardized structure
2. Run the MCP Server
# Start the MCP server
npm start
# Or for development
npm run devConfiguration
Environment variables:
IIA_REPO_PATH- Path to IIA resources directory (default:./iia-resources)IIA_GITHUB_REPO- Repository reference (default:organization/iia-resources)
MCP Server Features
Resources
Dynamic document serving from markdown files
Categorized access to all IIA content types
Metadata-rich responses with source URLs
Tools
search_documents - Search by keywords, standard numbers, or topics
get_standard_details - Retrieve specific standard information
get_related_documents - Find related content for topics
validate_compliance - Check scenarios against IIA standards
get_document_updates - Track recent changes and updates
Advanced Features
Content Caching for performance
Relevance Scoring for search results
Standard Number Detection for compliance validation
YAML Frontmatter Parsing for rich metadata
Development
File Formats
All scraped content includes YAML frontmatter:
---
title: "Standard Title"
url: "https://www.theiia.org/original-url"
category: "standards"
standard_number: "1100"
last_updated: "2024-01-15T10:30:00Z"
scraped_at: "2024-07-15T12:00:00Z"
---
# Content starts here...Code Standards
TypeScript with strict type checking
Async/await patterns throughout
Error handling and retry logic
Respectful scraping with rate limiting
Usage with AI Assistants
This MCP server enables AI assistants to:
Reference IIA Standards accurately in audit guidance
Validate Compliance scenarios against official standards
Search Documentation by topic, keyword, or standard number
Stay Current with the latest IIA updates and changes
Access Templates for audit programs and reports
Research and Education
This project is designed for research and educational purposes, providing structured access to public IIA resources for academic study and professional development in internal auditing.
License
MIT License - See LICENSE file for details.
Contributing
Fork the repository
Create a feature branch
Make your changes
Add tests if applicable
Submit a pull request
Support
For issues and questions:
Check existing GitHub issues
Create new issues with detailed descriptions
Include error logs and environment details
Available Tools
5 toolsget_document_updatesC
Check for recent updates to IIA documents
Inputs: category, since.
get_standard_detailsB
Get detailed information about a specific IIA standard
Inputs: standardNumber (required).
search_documentsC
Search IIA documents by keywords, standard numbers, or topics
Inputs: query (required), category, limit.
validate_complianceC
Check compliance against IIA standards and provide recommendations
Inputs: scenario (required), standardsToCheck.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 5 tools
Each tool has a clearly distinct purpose: get_document_updates focuses on recent changes, get_related_documents finds topic-based associations, get_standard_details provides standard-specific information, search_documents performs keyword-based retrieval, and validate_compliance assesses adherence to standards. There is no overlap or ambiguity in their functions.
All tool names follow a consistent verb_noun pattern using snake_case, starting with verbs like 'get', 'search', or 'validate' followed by descriptive nouns. This uniformity makes the tool set predictable and easy to understand.
With 5 tools, the server is well-scoped for its IIA document and standards management purpose. Each tool serves a specific, necessary function without redundancy, making the count appropriate for the domain.
The tool set covers key operations like retrieval (search, get details/updates/related documents) and compliance validation, supporting core workflows. A minor gap is the lack of tools for modifying or creating documents, but this may be intentional if the server is read-only.
Related MCP Connectors
AI governance MCP server for EU AI Act compliance and jurisdiction verification
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
A Model Context Protocol server for Wix AI tools
Compliance frameworks (SOC 2, ISO 27001, CMMC, NIST, more) delivered to AI agents as MCP tools.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceA comprehensive Model Context Protocol server implementation that enables AI assistants to interact with file systems, databases, GitHub repositories, web resources, and system tools while maintaining security and control.2-
- AlicenseNot gradedqualityDmaintenanceA Model Context Protocol server that allows AI assistants to invoke and interact with Integrator automation workflows through an API connection.11 npmMIT
- FlicenseNot gradedqualityDmaintenanceA Model Context Protocol server that provides AI models with structured access to external data and services, acting as a bridge between AI assistants and applications, databases, and APIs in a standardized, secure way.2-
- AlicenseNot gradedqualityDmaintenanceA Model Context Protocol server that enables AI assistants to interact with iOS simulators, perform accessibility testing, manage apps, and automate complex iOS workflows.32Apache 2.0