Skip to main content

tibet-pol-mcp

MCP server for tibet-pol — machine & process health monitoring with TIBET provenance.

Run infrastructure integrity checks via JSON templates. Every step is verified, dependency-chained, and signed with TIBET tokens. Like htop meets audit trail.

Part of the TIBET ecosystem by HumoticaOS.

Install

pip install tibet-pol-mcp

Claude Code / Claude Desktop Config

{
  "mcpServers": {
    "pol": {
      "command": "tibet-pol-mcp",
      "env": {
        "TIBET_POL_TEMPLATES": "/path/to/your/templates"
      }
    }
  }
}

Available Tools

Tool Description
pol_check Run health check against a template
pol_templates List available check templates
pol_template_info Get template details and steps
pol_diff Compare two runs — track infrastructure drift
pol_report Generate HTML report from results
pol_quick_health One-shot health percentage + failed steps

How It Works

Define infrastructure checks as JSON templates:

{
  "process_id": "my_stack",
  "name": "My Infrastructure",
  "steps": [
    {
      "id": "api_health",
      "name": "API responds",
      "check": "curl -sf http://localhost:8000/health",
      "critical": true,
      "intent": "Core API must be reachable"
    },
    {
      "id": "db_connected",
      "name": "Database connection",
      "check": "pg_isready -h localhost",
      "dependencies": ["api_health"],
      "critical": true
    }
  ]
}

Then check via MCP:

pol_check("my_stack")
# → 100% health, all steps valid, TIBET token chain

pol_quick_health("my_stack")
# → {"health": "100%", "checksum": "2/2", "failed_steps": []}

Step Statuses

Status Meaning
valid Check passed
drift Was passing, now failing (state change)
broken Check failed
blocked Dependency failed, step skipped
pending Not yet checked

Template Features

  • Dependencies: Steps can depend on other steps (topological sort)
  • Critical flags: Critical failures block dependent steps
  • Remediation: on_failure commands for auto-fix
  • Intents: Document WHY each check exists
  • Success criteria: Min percentage, all-critical rules
  • Alerts: Commands on critical failure or threshold breach

Environment Variables

Variable Default Description
TIBET_POL_TEMPLATES /srv/jtel-stack/tibet-pol-processes Templates directory

Related TIBET Packages

License

MIT — HumoticaOS

Metadata

Release files for tibet-pol-mcp 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for tibet-pol-mcp 0.1.0
File Size Uploaded
tibet_pol_mcp-0.1.0.tar.gz 5.9 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for tibet-pol-mcp 0.1.0
File Interpreter ABI Platform
tibet_pol_mcp-0.1.0-py3-none-any.whl Python 3 none any Details

Total release size: 13.1 kB

Release files / tibet_pol_mcp-0.1.0.tar.gz

Download URL tibet_pol_mcp-0.1.0.tar.gz
Size 5.9 kB
Tags Source
SHA-256 checksum
How to use checksums
5853b6b950dcb344d2826634050068ca47af4c85b4926f401455335463703e5a
BLAKE2b-256 checksum
How to use checksums
e4ece9afc9bd97f6d0ba710d823fc3eafc03ee7d60bb1bdb13d24a6d75efc4df
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.13.5

Release files / tibet_pol_mcp-0.1.0-py3-none-any.whl

Download URL tibet_pol_mcp-0.1.0-py3-none-any.whl
Size 7.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
30bcbe782aac7abf423f44979f61714d00d645d61cf5b1c97509d1427c27f683
BLAKE2b-256 checksum
How to use checksums
e18c3dacd1c6e827b24fdabddaee1484315c7d907709d9fb1479fbf70e928688
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.13.5

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page