Skip to content
MCP server

MCP Server for OSCAL

OSCAL schemas, catalogs and documents for AI agents, bundled and checked locally

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, self-hosted, Windows
Runs
Locally
Version
0.8.1
Listing updated
today

Similar MCP servers

About MCP Server for OSCAL

MCP Server for OSCAL is an open-source MCP server for security. It runs locally on your machine and is started by your AI client.

The author built this after finding that language models produced inconsistent OSCAL, NIST's machine-readable format for security controls, assessments and plans. The server bundles the OSCAL schemas and a content database so an assistant can answer with authoritative detail rather than guesses.

Tools cover schema and model metadata, Metaschema lookups for allowed values, constraints, references and definitions, multi-level content validation, component definition navigation, and generic list and query tools across catalogs, profiles, component definitions, SSPs, assessment plans and results, POA&Ms and mapping collections. Search comes in pairs: text search returns element IDs that a fetch tool resolves, and documentation queries return paged passages. Results never include filesystem paths.

It runs locally over stdio and, by default, connects to no remote service. At start it verifies SHA-256 hashes of the bundled schemas and database against build manifests; a schema mismatch blocks startup. The README warns not to use streamable-http since transport security is not implemented. A standalone OSCAL agent built on Strands and Bedrock ships in the same package, with optional AWS settings for documentation queries.

Install

Run in a terminal

claude mcp add mcp-server-for-oscal -- uvx mcp-server-for-oscal

Add to claude_desktop_config.json

{
  "mcpServers": {
    "mcp-server-for-oscal": {
      "command": "uvx",
      "args": [
        "mcp-server-for-oscal"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mcp-server-for-oscal": {
      "command": "uvx",
      "args": [
        "mcp-server-for-oscal"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "mcp-server-for-oscal": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "mcp-server-for-oscal"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mcp-server-for-oscal": {
      "command": "uvx",
      "args": [
        "mcp-server-for-oscal"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "mcp-server-for-oscal": {
      "command": "uvx",
      "args": [
        "mcp-server-for-oscal"
      ]
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • BEDROCK_MODEL_IDAWS Bedrock model ID for OSCAL documentation queries
  • OSCAL_KB_IDAWS Bedrock Knowledge Base ID for OSCAL documentation
  • AWS_PROFILEAWS CLI profile name for credential resolution
  • AWS_REGIONAWS region for Bedrock API calls
  • LOG_LEVELLogging verbosity level (DEBUG, INFO, WARNING, ERROR)

What it does

Bundled schemas
Authoritative OSCAL schemas ship with the server.
Metaschema lookups
Allowed values, constraints, references and definitions.
Document queries
List and query any OSCAL model type.
Content validation
Multi-level validation of OSCAL documents.
Integrity checks
SHA-256 manifests verified on startup.
Standalone agent
Optional Strands and Bedrock OSCAL agent.

Good for

  • Generate a valid minimal OSCAL mapping template
  • Check an SSP for constraint errors
  • Explore which models are generally available
  • Navigate a component definition for AWS services
  • Search OSCAL documentation from an assistant

Pricing

Open source

Free package on PyPI

MCP Server for OSCAL FAQ

Does it contact remote services?

Default tools do not; content is bundled.

Which transport should I use?

stdio; the README warns against streamable-http.

What is OSCAL?

NIST's framework-agnostic language for security controls assessment.

Can I use my own content?

Yes, via the OSCAL_DOCUMENTS_DIR setting.

Is MCP Server for OSCAL free?

Yes. MCP Server for OSCAL is open source, so you can use and self-host it for free.

How do I add MCP Server for OSCAL to Claude Code?

Run this command in your terminal: claude mcp add mcp-server-for-oscal -- uvx mcp-server-for-oscal

What are the best alternatives to MCP Server for OSCAL?

The closest alternatives to MCP Server for OSCAL are REA, AiSOC, redamon, x64dbg-mcp-server and Agent Roast.

Where this comes from

  • Description: written from the project's README.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers