Skip to main content
Glama
IIA-MCP Server

IIA-MCP Server

by rp4

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

  1. Scraper (scraper.ts) - Web scraping tool that downloads IIA resources

  2. MCP Server (iia_mcp_server.ts) - Serves scraped content via Model Context Protocol

  3. Structured 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 updates

Getting Started

Prerequisites

  • Node.js (v18+)

  • TypeScript

  • npm

Installation

# Install dependencies
npm install

# Build the project
npm run build

Usage

1. Scrape IIA Resources

# Run the scraper to download and format IIA content
npm run scrape

This will:

  • Create the iia-resources/ directory structure

  • Download 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 dev

Configuration

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

  1. search_documents - Search by keywords, standard numbers, or topics

  2. get_standard_details - Retrieve specific standard information

  3. get_related_documents - Find related content for topics

  4. validate_compliance - Check scenarios against IIA standards

  5. 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

  1. Fork the repository

  2. Create a feature branch

  3. Make your changes

  4. Add tests if applicable

  5. 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 tools
get_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

    A3.5/5.0

    Scored across 5 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    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.

    Tool Count5/5

    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.

    Completeness4/5

    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

    Related MCP Servers

    • F
      license
      Not graded
      quality
      D
      maintenance
      A 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
      -
    • F
      license
      Not graded
      quality
      D
      maintenance
      A 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
      -