MCP Server for OSCAL
OSCAL schemas, catalogs and documents for AI agents, bundled and checked locally
- 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-oscalAdd to claude_desktop_config.json
{
"mcpServers": {
"mcp-server-for-oscal": {
"command": "uvx",
"args": [
"mcp-server-for-oscal"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"mcp-server-for-oscal": {
"command": "uvx",
"args": [
"mcp-server-for-oscal"
]
}
}
}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 queriesOSCAL_KB_IDAWS Bedrock Knowledge Base ID for OSCAL documentationAWS_PROFILEAWS CLI profile name for credential resolutionAWS_REGIONAWS region for Bedrock API callsLOG_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.



