# arian-gogani/nobulex [Health: Active]

**Category:** 🔒 Security  
**Repository:** https://github.com/arian-gogani/nobulex  
**GitHub Stars:** 39  
**Views:** 4  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/arian-gogani-nobulex

## Description
Proof-of-behavior enforcement for AI agents. Define behavioral covenant rules (permit/forbid/require), enforce at runtime before execution, get SHA-256 hash-chained tamper-evident audit logs, and verify compliance independently. Cross-agent verification handshake — no proof, no transaction. MIT licensed, 4,244 tests.

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `uvx` (confidence: high):

```json
"mcpServers": {
  "nobulex": {
    "command": "uvx",
    "args": ["nobulex"]
  }
}
```

## Documentation

## What arian-gogani/nobulex MCP server does

arian-gogani/nobulex MCP server is a reference implementation of an earlier Nobulex protocol for recording and evaluating autonomous-agent behavior. It produces cryptographic receipts for agent actions, maintains a cumulative trust score, and can restrict access based on that score. The repository description also identifies permit, forbid, and require covenant rules that can be checked at runtime before an action executes.

The repository is MIT licensed and publishes Python and JavaScript/TypeScript packages. It is not presented in the supplied material as an MCP implementation or as the current Nobulex product. The README explicitly says this repository is a prior direction and points current work to nobulex-registry and nobulex.com.

## How it works

Each action receives a receipt signed with Ed25519 before and after execution. Receipts are linked into a hash chain, allowing a verifier to detect changes to the history. The README's example shows that changing one byte causes verification to fail. Verification can be performed by another party using the agent's public key, without trusting the agent or the operator that produced the file.

Trust scores accumulate from recorded behavior and map to access tiers. The documented tiers range from Restricted, with read-only or sandboxed execution, through Standard and Trusted, to Sovereign, which represents full autonomy. The example also shows actions being blocked when the agent lacks sufficient trust and allowed after the score reaches a higher tier.

The Python API includes both an `Agent` interface and a `track` decorator for adding receipts to existing functions. Exported audit trails can be checked with `verify_audit_trail`. The repository also contains adapters for LangChain, CrewAI, Google ADK, PydanticAI, Haystack, and LlamaIndex.

## Setup and configuration

The documented Python installation is `pip install nobulex`. JavaScript and TypeScript projects can install `@nobulex/core` with `npm install @nobulex/core`. A minimal Python example creates an `Agent`, records an action, and calls `receipt.verify()`.

The material does not specify environment variables, API credentials, a hosted endpoint, or an MCP configuration. It shows keys being generated for agents and public keys being supplied when verifying an exported trail, but it does not describe a separate account or paid service requirement.

## Limitations and notes

The main limitation for an MCP directory listing is scope: arian-gogani/nobulex MCP server is not documented here as an MCP server with MCP tools, transports, or client configuration. Do not assume that installing the Python or npm package creates an MCP endpoint. The repository itself states that its implementation is no longer the direction being built, while the current project is nobulex-registry.

The supplied material describes protocol behavior and SDK examples, but does not provide a complete specification for every covenant rule, trust-score calculation, operator identity mechanism, or production deployment model. Validate those details against the repository and draft specification before relying on the project for enforcement or governance decisions.

_Full upstream README: https://allmcps.com/mcp/arian-gogani-nobulex/readme_