Model Context Protocol (MCP) server for Evidentia — exposes gap analysis, risk generation, explanation, and OSCAL emit to MCP-aware AI clients (Claude Desktop, Claude Code, ChatGPT, etc.)
Project description
evidentia-mcp
Model Context Protocol (MCP) server for Evidentia.
Exposes Evidentia's gap analysis, risk-statement generation, control explanation, OSCAL emit, and gap-diff surfaces to MCP-aware AI clients (Claude Desktop, Claude Code, ChatGPT Desktop, custom MCP clients).
Quick start
pip install evidentia[mcp]
# Run the server over stdio (the canonical MCP transport)
evidentia mcp serve
# Health check (validates SDK availability + reachable
# evidentia-core / evidentia-ai surfaces)
evidentia mcp doctor
Tool surface
| Tool | Maps to | Auth |
|---|---|---|
gap_analyze |
evidentia_core.gap_analyzer |
none (read-only) |
risk_generate |
evidentia_ai.risk_statements |
optional API key (LiteLLM env vars) |
explain_control |
evidentia_ai.explain |
optional API key |
oscal_emit |
evidentia_core.oscal.exporter |
optional Sigstore identity (env-driven) |
gap_diff |
evidentia_core.gap_analyzer.diff |
none |
collect_aws |
evidentia_collectors.aws |
provider creds (env-driven) |
collect_github |
evidentia_collectors.github |
provider creds |
collect_jira |
evidentia_collectors.jira |
provider creds |
All credential handling follows the same env-var-driven secret-handling protocol Evidentia uses everywhere — the MCP server NEVER accepts credentials in tool arguments.
Transport
v0.8.0 ships the stdio transport only (the most common + canonical MCP transport — used by Claude Desktop, Claude Code, and most other MCP clients). HTTP transport + Client ID Metadata Document (CIMD) richness defer to v0.8.1.
License
Apache-2.0. See the workspace root LICENSE file.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file evidentia_mcp-0.8.0.tar.gz.
File metadata
- Download URL: evidentia_mcp-0.8.0.tar.gz
- Upload date:
- Size: 8.4 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.13
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
35a16d85226681591f2e3604f2d9fce8c8238296a5f5432e5c2e994d1c3bfb9a
|
|
| MD5 |
2ecf0d3993ca4654e4a902ce2b8ccecd
|
|
| BLAKE2b-256 |
c27748e3ef5ac5eab8e0bafb17ae98d3eafaeeea75147c9d5c26757e415f9556
|
Provenance
The following attestation bundles were made for evidentia_mcp-0.8.0.tar.gz:
Publisher:
release.yml on allenfbyrd/evidentia
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
evidentia_mcp-0.8.0.tar.gz -
Subject digest:
35a16d85226681591f2e3604f2d9fce8c8238296a5f5432e5c2e994d1c3bfb9a - Sigstore transparency entry: 1443887593
- Sigstore integration time:
-
Permalink:
allenfbyrd/evidentia@f3162c254226dee483b2d867c6b82301d979beb9 -
Branch / Tag:
refs/tags/v0.8.0 - Owner: https://github.com/allenfbyrd
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@f3162c254226dee483b2d867c6b82301d979beb9 -
Trigger Event:
push
-
Statement type:
File details
Details for the file evidentia_mcp-0.8.0-py3-none-any.whl.
File metadata
- Download URL: evidentia_mcp-0.8.0-py3-none-any.whl
- Upload date:
- Size: 8.2 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.13
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
5d49be4deb27576eaa662b8950dba26a167f279ea74ad4c3f58bb222665b6e6a
|
|
| MD5 |
477a57a4029f33ff0452ae440572f821
|
|
| BLAKE2b-256 |
6033b836c000b0e82fe93451b6321c2fee0950005ba9666e18f2fe7ce6b0f3d8
|
Provenance
The following attestation bundles were made for evidentia_mcp-0.8.0-py3-none-any.whl:
Publisher:
release.yml on allenfbyrd/evidentia
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
evidentia_mcp-0.8.0-py3-none-any.whl -
Subject digest:
5d49be4deb27576eaa662b8950dba26a167f279ea74ad4c3f58bb222665b6e6a - Sigstore transparency entry: 1443888018
- Sigstore integration time:
-
Permalink:
allenfbyrd/evidentia@f3162c254226dee483b2d867c6b82301d979beb9 -
Branch / Tag:
refs/tags/v0.8.0 - Owner: https://github.com/allenfbyrd
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@f3162c254226dee483b2d867c6b82301d979beb9 -
Trigger Event:
push
-
Statement type: