MCP Kinetic Gain

mcp-kinetic-gain

One MCP server, all twelve Kinetic Gain Protocol Suite specs + the v0.1.0 implementation tooling + the DefenseTech 6-pack semantics (8 tools). 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 agent-facing companion to kinetic-gain-visualizer: the visualizer renders the specs for humans, while this server exposes validation and workflow tools for agents. The optional audit_event_emit tool sends an event to a configured audit-stream service.

Tools

75 tools

• 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 declared policy posture and any
• 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 - Compare an AUP with a Student AI Disclosure on eight declared
• 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 - Validate each rubric row, then infer a preview decision.status
• decision_card_to_policy_bundle - Read-only deny preview for rejected, withdrawn, expired, or
• 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 against a body and
• 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 - POSTs a governance event to the audit-stream-py instance
• audit_events_query - GET recent governance events from a running audit-stream-py
• audit_chain_verify_live - Ask the configured audit-stream service to check its full
• 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 - Deterministic preview of a DefenseTech 3-axis vault contract
• defensetech_audit_event_check_invariants - Run three deterministic DefenseTech event checks: CUI
• defensetech_check_dfars_72h_clock - Calculate the DFARS 252.204-7012 discovery-to-filing 72-hour
• 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 against the bundled v0.1
• 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

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.

Network and data boundaries

URL fetch tools make outbound HTTP(S) requests to user-supplied origins. The server rejects local and nonpublic destinations, rechecks redirects, and limits JSON responses to 1 MB. The optional live audit tools require both AUDIT_STREAM_URL and AUDIT_STREAM_TOKEN in the MCP server's environment. The token must match the audit-stream service's bearer token and have at least 32 visible ASCII characters. Use HTTPS for a remote service; HTTP is accepted only for loopback development. Missing or invalid configuration returns an error without sending a request. audit_event_emit sends kind, caller-asserted source, and payload to the configured service and validates its event receipt. The receipt does not prove durable storage or event completeness. Its shared token authenticates this MCP process, not the source label or tenant. Approve the write before calling it; omit secrets and personal data unless the service is approved for them. Hash-chain verification checks continuity only; it does not prove audit completeness.

Schema validation checks the document shape and selected rules. A passing result is not proof of FERPA, COPPA, HIPAA, FDA, EU AI Act, CMMC, export-control status, or other legal compliance. attestation_verify checks a signature against the public key supplied by the caller; it does not establish the key owner's identity. aup_check_compliance evaluates eight disclosed fields only; it does not check policy scope, tool/vendor requirements, parent consent, or Tutor Cards. A true allowed value is not an authorization grant. DefenseTech tools calculate from supplied data; they do not classify materials or verify a person's status or license. Positive Decision Cards require the live policy engine's identity, scope, action, expiry, and trusted-attestation checks before an enforceable bundle can be created.

The DefenseTech 72-hour clock uses the time an incident was discovered, not when it occurred or when an audit event was created. Supply discovered_at and filed_at with time zones; see DFARS 252.204-7012. A report's actual submission and contract applicability require external evidence.

Start with a task

• Review a card: pass a parsed document to claims_card_validate, then use claims_card_inspect to summarize its declared decision. Investigate any validation failure before relying on the summary.
• Compare drafts: call suite_doc_drift with two versions of the same Suite document to see structural changes before publication.
• Check a signature: call attestation_verify with a public key obtained through a trusted channel; separately confirm that the key belongs to the claimed signer.
• Record an event: prepare the payload with audit_event_compose, review it for sensitive data, then call audit_event_emit only when the configured audit-stream service and write are approved.

Install

The commands below install the version currently published on npm. To run this source checkout instead, use npm ci, npm run build, then node dist/server.js. Check npm view mcp-kinetic-gain version before relying on a particular source change.

npm install -g mcp-kinetic-gain

Or run without installing via npx:

npx mcp-kinetic-gain

For a controlled deployment, pin a reviewed package version in the client config (mcp-kinetic-gain@ ) and upgrade deliberately.

Claude Desktop config

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

{

"mcpServers": { "kinetic-gain"