MCP Kinetic Gain

by mizcausevic-dev

449 downloads Not rated yet AGPL-3.0

About

Unified MCP server for all 11 Kinetic Gain Protocol Suite specs + DefenseTech module (8 tools) — 71 callable tools (47 spec + 16 implementation + 8 DefenseTech). One Claude Desktop config entry. Stdio, no API key, no build step.

Details

License
AGPL-3.0

Explore

- 75 tools across 12 Kinetic Gain Suite specs
- Hash attestation (ed25519) and audit-stream chain verification
- Cross-spec drift detection between document versions
- DefenseTech vault resolver and invariant checkers
- AI Claims Decision Card (InsurTech) support
- CLI mode for CI/pre-commit validation

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name MCP Kinetic Gain
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

npm install -g mcp-kinetic-gain

Or run without installing via npx:

npx mcp-kinetic-gain

Add to your claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\):

{
  "mcpServers": {
    "kinetic-gain": {
      "command": "npx",
      "args": ["-y", "mcp-kinetic-gain"]
    }
  }
}

Restart Claude. All 75 tools appear in the tools panel. Try:

> "Use aeo_inspect on https://mizcausevic-dev.github.io to summarize the entity declaration, then use ai_evidence_verify_hash to check the content_hash of an evidence object against my candidate text."

aeo_fetch

Fetch the full AEO Protocol declaration at an origin's

aeo_inspect

Return a structured summary of an AEO declaration: entity

aeo_get_claim

Extract a single AEO claim by ID

aeo_well_known_url

Compute the canonical AEO well-known URL for an origin

prompt_provenance_validate

Validate a Prompt Provenance JSON document against the v0.1

prompt_provenance_inspect

Structured summary of a Prompt Provenance document: prompt

prompt_provenance_eval_result

Extract a single evaluation suite's result from a Prompt

agent_card_well_known_url

Compute the canonical Agent Card well-known URL for a given

agent_card_inspect

Structured summary of an Agent Card document

agent_card_tool_disclosure

Return the list of tools an agent declares, with side-effect

agent_card_validate

Validate an Agent Card JSON document against the v0.1 schema.

ai_evidence_validate

Validate an AI Evidence object against the v0.1 schema.

ai_evidence_inspect

Structured summary of an AI Evidence object: claim text

ai_evidence_verify_hash

Compute SHA-256 over the canonical UTF-8 form of

tool_card_well_known_url

Compute the canonical MCP Tool Card well-known URL

tool_card_inspect

Structured summary of an MCP Tool Card: tool identity, safety

tool_card_tested_with

Return the tested-LLM entries for a tool, optionally filtered

tool_card_validate

Validate an MCP Tool Card JSON document against the v0.1

tutor_card_well_known_url

Compute the canonical AI Tutor Card well-known URL

tutor_card_fetch

Fetch a Tutor Card from a URL

tutor_card_validate

Validate an AI Tutor Card JSON document against the v0.1

tutor_card_inspect

Structured summary of a Tutor Card: tutor identity, audience

tutor_card_subject_check

Classify a topic against the tutor's subject scope

tutor_card_coppa_check

Enforce the spec's COPPA conditional rule: if

disclosure_validate

Validate a Student AI Disclosure JSON document against the

disclosure_inspect

Structured summary of a Student AI Disclosure: assignment

disclosure_verify_artifact_hash

Recompute SHA-256 over a candidate artifact and compare to

disclosure_verify_prompt_hash

Verify a single prompt hash in a hashed-mode disclosure

disclosure_aup_check

Surface the disclosure's policy posture: whether an aup_uri

aup_well_known_url

Compute the canonical Classroom AI AUP well-known URL

aup_fetch

Fetch a Classroom AI AUP from a URL

aup_validate

Validate a Classroom AI AUP JSON document against the v0.1

aup_inspect

Structured summary of a Classroom AI AUP: policy identity

aup_check_compliance

HEADLINE TOOL, joins an AUP with a Student AI Disclosure and

clinical_ai_well_known_url

Compute the canonical Clinical AI Card well-known URL

clinical_ai_fetch

Fetch a Clinical AI Card from a URL

clinical_ai_validate

Validate a Clinical AI Card JSON document against the v0.1

clinical_ai_inspect

Structured summary of a Clinical AI Card: system identity

incident_well_known_url

Compute the canonical AI Incident Card well-known URL

incident_fetch

Fetch an AI Incident Card from a URL

incident_validate

Validate an AI Incident Card JSON document against the v0.1

incident_inspect

Structured summary of an AI Incident Card: incident identity

incident_index_fetch

HEADLINE TOOL, fetch a vendor's

decision_card_well_known_url

Compute the canonical AI Procurement Decision Card well-known

decision_card_fetch

Fetch an AI Procurement Decision Card from a URL

decision_card_validate

Validate an AI Procurement Decision Card JSON document

decision_card_inspect

Structured summary of an AI Procurement Decision Card: buyer

decision_card_infer_status

Given a rubric, infer the right decision.status

decision_card_to_policy_bundle

Translate a Decision Card into the PolicyBundle that

decision_card_signature_check

Structural check on a Decision Card's signatures[] block

incident_affected_walk

Walk an Incident Card's affected block and return every

incident_remediation_plan

Map each affected URI in an Incident Card to a recommended

attestation_canonical_hash

Compute the SHA-256 canonical-JSON hash of an arbitrary value

attestation_verify

Verify an ed25519 Attestation envelope

attestation_inspect

Pretty-print an Attestation envelope with structural

audit_event_compose

Build a ready-to-POST audit-stream-py GovernanceEvent

audit_chain_verify

Walk an array of GovernanceEvents top-to-bottom and verify

audit_event_inspect

Pretty-print one GovernanceEvent with structural validation

audit_event_emit

POST one governance event to a running audit-stream-py

audit_events_query

GET recent governance events from a running audit-stream-py

audit_chain_verify_live

Ask a running audit-stream-py instance to walk its own chain

suite_doc_detect_spec

Detect which Kinetic Gain Suite spec a JSON document is by

suite_doc_drift

Structural diff between two versions of the same Suite

defensetech_vault_resolve_3axis

Resolve a (CUI tier, export-control status, foreign-person

defensetech_audit_event_check_invariants

Run all 3 DefenseTech audit-stream invariants against a

defensetech_check_dfars_72h_clock

Check DFARS 252.204-7012(c)(1)(ii) 72-hour cyber-incident

defensetech_check_cui_distribution_statement

Check that a CUI-Specified+ tier event carries the required

defensetech_check_itar_us_person

Check that an ITAR resource event has US-PERSON-VERIFIED (or

defensetech_incident_classify_event_type

Given a freeform description of a defense-AI incident

defensetech_summarize_cmmc_evidence_bundle

Summarize a CMMC L2/L3 readiness evidence bundle: target

defensetech_vault_contract_cross_binding_check

Verify the cross_binding_refs block on a DefenseTech vault

claims_card_validate

Validate an AI Claims Decision Card (InsurTech) JSON document

claims_card_inspect

Structured summary of an AI Claims Decision Card: claim type

claims_card_sign

Compute the canonical SHA-256 hash of an AI Claims Decision

claims_card_chain

Link a new AI Claims Decision Card to its predecessor: sets

<!-- BEGIN TOOL CATALOG (generated by scripts/gen-readme-tools.mjs from src/tools.ts - do not hand-edit) -->
<details>
<summary>75 tools</summary>

- aeo_fetch - Fetch the full AEO Protocol declaration at an origin's
- aeo_inspect - Return a structured summary of an AEO declaration: entity
- aeo_get_claim - Extract a single AEO claim by ID
- aeo_well_known_url - Compute the canonical AEO well-known URL for an origin
- prompt_provenance_validate - Validate a Prompt Provenance JSON document against the v0.1
- prompt_provenance_inspect - Structured summary of a Prompt Provenance document: prompt
- prompt_provenance_eval_result - Extract a single evaluation suite's result from a Prompt
- agent_card_well_known_url - Compute the canonical Agent Card well-known URL for a given
- agent_card_inspect - Structured summary of an Agent Card document
- agent_card_tool_disclosure - Return the list of tools an agent declares, with side-effect
- agent_card_validate - Validate an Agent Card JSON document against the v0.1 schema.
- ai_evidence_validate - Validate an AI Evidence object against the v0.1 schema.
- ai_evidence_inspect - Structured summary of an AI Evidence object: claim text
- ai_evidence_verify_hash - Compute SHA-256 over the canonical UTF-8 form of
- tool_card_well_known_url - Compute the canonical MCP Tool Card well-known URL
- tool_card_inspect - Structured summary of an MCP Tool Card: tool identity, safety
- tool_card_tested_with - Return the tested-LLM entries for a tool, optionally filtered
- tool_card_validate - Validate an MCP Tool Card JSON document against the v0.1
- tutor_card_well_known_url - Compute the canonical AI Tutor Card well-known URL
- tutor_card_fetch - Fetch a Tutor Card from a URL
- tutor_card_validate - Validate an AI Tutor Card JSON document against the v0.1
- tutor_card_inspect - Structured summary of a Tutor Card: tutor identity, audience
- tutor_card_subject_check - Classify a topic against the tutor's subject scope
- tutor_card_coppa_check - Enforce the spec's COPPA conditional rule: if
- disclosure_validate - Validate a Student AI Disclosure JSON document against the
- disclosure_inspect - Structured summary of a Student AI Disclosure: assignment
- disclosure_verify_artifact_hash - Recompute SHA-256 over a candidate artifact and compare to
- disclosure_verify_prompt_hash - Verify a single prompt hash in a hashed-mode disclosure
- disclosure_aup_check - Surface the disclosure's policy posture: whether an aup_uri
- aup_well_known_url - Compute the canonical Classroom AI AUP well-known URL
- aup_fetch - Fetch a Classroom AI AUP from a URL
- aup_validate - Validate a Classroom AI AUP JSON document against the v0.1
- aup_inspect - Structured summary of a Classroom AI AUP: policy identity
- aup_check_compliance - HEADLINE TOOL, joins an AUP with a Student AI Disclosure and
- clinical_ai_well_known_url - Compute the canonical Clinical AI Card well-known URL
- clinical_ai_fetch - Fetch a Clinical AI Card from a URL
- clinical_ai_validate - Validate a Clinical AI Card JSON document against the v0.1
- clinical_ai_inspect - Structured summary of a Clinical AI Card: system identity
- incident_well_known_url - Compute the canonical AI Incident Card well-known URL
- incident_fetch - Fetch an AI Incident Card from a URL
- incident_validate - Validate an AI Incident Card JSON document against the v0.1
- incident_inspect - Structured summary of an AI Incident Card: incident identity
- incident_index_fetch - HEADLINE TOOL, fetch a vendor's
- decision_card_well_known_url - Compute the canonical AI Procurement Decision Card well-known
- decision_card_fetch - Fetch an AI Procurement Decision Card from a URL
- decision_card_validate - Validate an AI Procurement Decision Card JSON document
- decision_card_inspect - Structured summary of an AI Procurement Decision Card: buyer
- decision_card_infer_status - Given a rubric, infer the right decision.status
- decision_card_to_policy_bundle - Translate a Decision Card into the PolicyBundle that
- decision_card_signature_check - Structural check on a Decision Card's signatures[] block
- incident_affected_walk - Walk an Incident Card's affected block and return every
- incident_remediation_plan - Map each affected URI in an Incident Card to a recommended
- attestation_canonical_hash - Compute the SHA-256 canonical-JSON hash of an arbitrary value
- attestation_verify - Verify an ed25519 Attestation envelope
- attestation_inspect - Pretty-print an Attestation envelope with structural
- audit_event_compose - Build a ready-to-POST audit-stream-py GovernanceEvent
- audit_chain_verify - Walk an array of GovernanceEvents top-to-bottom and verify
- audit_event_inspect - Pretty-print one GovernanceEvent with structural validation
- audit_event_emit - POST one governance event to a running audit-stream-py
- audit_events_query - GET recent governance events from a running audit-stream-py
- audit_chain_verify_live - Ask a running audit-stream-py instance to walk its own chain
- suite_doc_detect_spec - Detect which Kinetic Gain Suite spec a JSON document is by
- suite_doc_drift - Structural diff between two versions of the same Suite
- defensetech_vault_resolve_3axis - Resolve a (CUI tier, export-control status, foreign-person
- defensetech_audit_event_check_invariants - Run all 3 DefenseTech audit-stream invariants against a
- defensetech_check_dfars_72h_clock - Check DFARS 252.204-7012(c)(1)(ii) 72-hour cyber-incident
- defensetech_check_cui_distribution_statement - Check that a CUI-Specified+ tier event carries the required
- defensetech_check_itar_us_person - Check that an ITAR resource event has US-PERSON-VERIFIED (or
- defensetech_incident_classify_event_type - Given a freeform description of a defense-AI incident
- defensetech_summarize_cmmc_evidence_bundle - Summarize a CMMC L2/L3 readiness evidence bundle: target
- defensetech_vault_contract_cross_binding_check - Verify the cross_binding_refs block on a DefenseTech vault
- claims_card_validate - Validate an AI Claims Decision Card (InsurTech) JSON document
- claims_card_inspect - Structured summary of an AI Claims Decision Card: claim type
- claims_card_sign - Compute the canonical SHA-256 hash of an AI Claims Decision
- claims_card_chain - Link a new AI Claims Decision Card to its predecessor: sets

</details>
<!-- END TOOL CATALOG -->

Specs with a well-known URL convention (AEO, Agent Cards, Tool Cards) get fetch tools. Specs without one (Prompt Provenance, AI Evidence - these usually travel inline with answers or in repos, not at fixed paths) get parse tools that take a document_json string.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "mcp kinetic gain": {
            "kinetic-gain": {
                "command": "npx",
                "args": [
                    "-y",
                    "mcp-kinetic-gain"
                ]
            }
        }
    }
}

McpServers

{
    "kinetic-gain": {
        "command": "npx",
        "args": [
            "-y",
            "mcp-kinetic-gain"
        ]
    }
}

One MCP server, all twelve Kinetic Gain Protocol Suite specs + the v0.1.0 implementation tooling + the DefenseTech 6-pack. Drop into Claude Desktop, Cursor, or any MCP-compatible client with a single config entry. The agent gains 75 tools (47 spec + 16 implementation-preview + 8 DefenseTech + 4 AI Claims Decision Card, v0.9.0): AEO Protocol, Prompt Provenance, Agent Cards, AI Evidence Format, MCP Tool Cards, AI Tutor Cards, Student AI Disclosure, Classroom AI AUP, Clinical AI Disclosure, AI Incident Card, AI Procurement Decision Card, AI Claims Decision Card - plus hash attestation (ed25519), audit-stream event composition + chain verification (offline AND live against a running audit-stream-py via AUDIT_STREAM_URL), cross-spec drift detection, Decision Intelligence preview, and the DefenseTech vault resolver + invariant checkers. New in v0.9.0: the AI Claims Decision Card (InsurTech, claims_card_version) - claims_card_validate, claims_card_inspect, claims_card_sign, claims_card_chain.

This is the unified read-side companion to kinetic-gain-visualizer: the visualizer renders any of the 12 specs for humans, this server exposes them as callable tools for agents.

Tools

<!-- BEGIN TOOL CATALOG (generated by scripts/gen-readme-tools.mjs from src/tools.ts - do not hand-edit) -->
<details>
<summary>75 tools</summary>

- aeo_fetch - Fetch the full AEO Protocol declaration at an origin's
- aeo_inspect - Return a structured summary of an AEO declaration: entity
- aeo_get_claim - Extract a single AEO claim by ID
- aeo_well_known_url - Compute the canonical AEO well-known URL for an origin
- prompt_provenance_validate - Validate a Prompt Provenance JSON document against the v0.1
- prompt_provenance_inspect - Structured summary of a Prompt Provenance document: prompt
- prompt_provenance_eval_result - Extract a single evaluation suite's result from a Prompt
- agent_card_well_known_url - Compute the canonical Agent Card well-known URL for a given
- agent_card_inspect - Structured summary of an Agent Card document
- agent_card_tool_disclosure - Return the list of tools an agent declares, with side-effect
- agent_card_validate - Validate an Agent Card JSON document against the v0.1 schema.
- ai_evidence_validate - Validate an AI Evidence object against the v0.1 schema.
- ai_evidence_inspect - Structured summary of an AI Evidence object: claim text
- ai_evidence_verify_hash - Compute SHA-256 over the canonical UTF-8 form of
- tool_card_well_known_url - Compute the canonical MCP Tool Card well-known URL
- tool_card_inspect - Structured summary of an MCP Tool Card: tool identity, safety
- tool_card_tested_with - Return the tested-LLM entries for a tool, optionally filtered
- tool_card_validate - Validate an MCP Tool Card JSON document against the v0.1
- tutor_card_well_known_url - Compute the canonical AI Tutor Card well-known URL
- tutor_card_fetch - Fetch a Tutor Card from a URL
- tutor_card_validate - Validate an AI Tutor Card JSON document against the v0.1
- tutor_card_inspect - Structured summary of a Tutor Card: tutor identity, audience
- tutor_card_subject_check - Classify a topic against the tutor's subject scope
- tutor_card_coppa_check - Enforce the spec's COPPA conditional rule: if
- disclosure_validate - Validate a Student AI Disclosure JSON document against the
- disclosure_inspect - Structured summary of a Student AI Disclosure: assignment
- disclosure_verify_artifact_hash - Recompute SHA-256 over a candidate artifact and compare to
- disclosure_verify_prompt_hash - Verify a single prompt hash in a hashed-mode disclosure
- disclosure_aup_check - Surface the disclosure's policy posture: whether an aup_uri
- aup_well_known_url - Compute the canonical Classroom AI AUP well-known URL
- aup_fetch - Fetch a Classroom AI AUP from a URL
- aup_validate - Validate a Classroom AI AUP JSON document against the v0.1
- aup_inspect - Structured summary of a Classroom AI AUP: policy identity
- aup_check_compliance - HEADLINE TOOL, joins an AUP with a Student AI Disclosure and
- clinical_ai_well_known_url - Compute the canonical Clinical AI Card well-known URL
- clinical_ai_fetch - Fetch a Clinical AI Card from a URL
- clinical_ai_validate - Validate a Clinical AI Card JSON document against the v0.1
- clinical_ai_inspect - Structured summary of a Clinical AI Card: system identity
- incident_well_known_url - Compute the canonical AI Incident Card well-known URL
- incident_fetch - Fetch an AI Incident Card from a URL
- incident_validate - Validate an AI Incident Card JSON document against the v0.1
- incident_inspect - Structured summary of an AI Incident Card: incident identity
- incident_index_fetch - HEADLINE TOOL, fetch a vendor's
- decision_card_well_known_url - Compute the canonical AI Procurement Decision Card well-known
- decision_card_fetch - Fetch an AI Procurement Decision Card from a URL
- decision_card_validate - Validate an AI Procurement Decision Card JSON document
- decision_card_inspect - Structured summary of an AI Procurement Decision Card: buyer
- decision_card_infer_status - Given a rubric, infer the right decision.status
- decision_card_to_policy_bundle - Translate a Decision Card into the PolicyBundle that
- decision_card_signature_check - Structural check on a Decision Card's signatures[] block
- incident_affected_walk - Walk an Incident Card's affected block and return every
- incident_remediation_plan - Map each affected URI in an Incident Card to a recommended
- attestation_canonical_hash - Compute the SHA-256 canonical-JSON hash of an arbitrary value
- attestation_verify - Verify an ed25519 Attestation envelope
- attestation_inspect - Pretty-print an Attestation envelope with structural
- audit_event_compose - Build a ready-to-POST audit-stream-py GovernanceEvent
- audit_chain_verify - Walk an array of GovernanceEvents top-to-bottom and verify
- audit_event_inspect - Pretty-print one GovernanceEvent with structural validation
- audit_event_emit - POST one governance event to a running audit-stream-py
- audit_events_query - GET recent governance events from a running audit-stream-py
- audit_chain_verify_live - Ask a running audit-stream-py instance to walk its own chain
- suite_doc_detect_spec - Detect which Kinetic Gain Suite spec a JSON document is by
- suite_doc_drift - Structural diff between two versions of the same Suite
- defensetech_vault_resolve_3axis - Resolve a (CUI tier, export-control status, foreign-person
- defensetech_audit_event_check_invariants - Run all 3 DefenseTech audit-stream invariants against a
- defensetech_check_dfars_72h_clock - Check DFARS 252.204-7012(c)(1)(ii) 72-hour cyber-incident
- defensetech_check_cui_distribution_statement - Check that a CUI-Specified+ tier event carries the required
- defensetech_check_itar_us_person - Check that an ITAR resource event has US-PERSON-VERIFIED (or
- defensetech_incident_classify_event_type - Given a freeform description of a defense-AI incident
- defensetech_summarize_cmmc_evidence_bundle - Summarize a CMMC L2/L3 readiness evidence bundle: target
- defensetech_vault_contract_cross_binding_check - Verify the cross_binding_refs block on a DefenseTech vault
- claims_card_validate - Validate an AI Claims Decision Card (InsurTech) JSON document
- claims_card_inspect - Structured summary of an AI Claims Decision Card: claim type
- claims_card_sign - Compute the canonical SHA-256 hash of an AI Claims Decision
- claims_card_chain - Link a new AI Claims Decision Card to its predecessor: sets

</details>
<!-- END TOOL CATALOG -->

Specs with a well-known URL convention (AEO, Agent Cards, Tool Cards) get fetch tools. Specs without one (Prompt Provenance, AI Evidence - these usually travel inline with answers or in repos, not at fixed paths) get parse tools that take a document_json string.

Install

npm install -g mcp-kinetic-gain

Or run without installing via npx:

npx mcp-kinetic-gain

Claude Desktop config

Add to your claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\):

{
  "mcpServers": {
    "kinetic-gain": {
      "command": "npx",
      "args": ["-y", "mcp-kinetic-gain"]
    }
  }
}

Restart Claude. All 75 tools appear in the tools panel. Try:

> "Use aeo_inspect on https://mizcausevic-dev.github.io to summarize the entity declaration, then use ai_evidence_verify_hash to check the content_hash of an evidence object against my candidate text."

CLI mode (v0.5.1+)

The same binary doubles as a Suite JSON validator outside any MCP host. Useful in CI, pre-commit hooks, or local sanity-checks.

```bash

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.