Skip to content

MCP_GUIDE.md

Latest commit

 

History

History
95 lines (76 loc) · 3.73 KB

MCP_GUIDE.md

File metadata and controls

95 lines (76 loc) · 3.73 KB
Raw

Model Context Protocol (MCP) Guide for HEAV3NS-PRESS

Docs Hub · Agent Stack · Agent Harnesses · CLI Reference · Public API

HEAV3NS-PRESS includes a native Model Context Protocol (MCP) stdio server complying with the 2024-11-05 specification. Autonomous AI agents (Claude Desktop, Cursor, Antigravity, Windsurf) can directly manage, publish, search, observe, and heal HEAV3NS-PRESS without writing web scraping or shell scripts.

1. Running the MCP Server

Start the MCP server from the command line:

heav3ns-press mcp

Or target a specific storage directory:

heav3ns-press --dir /path/to/content-dir mcp

2. Configuring in Claude Desktop

Add HEAV3NS-PRESS to your claude_desktop_config.json:

{
  "mcpServers": {
    "heav3ns-press": {
      "command": "heav3ns-press",
      "args": ["--dir", "/home/user/.heav3ns", "mcp"]
    }
  }
}

3. Configuring in Cursor / Antigravity

In your agent or project settings:

{
  "mcpServers": {
    "heav3ns-press": {
      "command": "/usr/local/bin/heav3ns-press",
      "args": ["mcp"]
    }
  }
}

4. Available MCP Tools

Tool Name Parameters Description
publish_post slug, title, body, author?, publish?, schedule? Create or update article and publish or schedule
list_posts status?, limit?, offset? Query articles filtered by status
get_post slug Retrieve post metadata, full markdown, and SHA-256
search_posts query, limit? Full-text keyword search across published articles
list_revisions slug Inspect historical versions and cryptographic hashes
rollback_revision slug, target_version Rollback an article to a prior revision number
get_diagnostics (none) Inspect system state, storage, uptime, and checks
reconcile_and_heal (none) Trigger self-healing state reconciliation
create_backup (none) Create an atomic Merkle-verified backup
list_backups (none) List all verified backups
restore_backup backup_id Restore full publication state from backup ID
list_quarantine (none) List isolated corrupted records
run_tick (none) Run one autonomous supervisor maintenance cycle
get_cache_stats (none) Retrieve JoyRide cache telemetry & hit ratio
clear_cache (none) Purge all entries from the JoyRide cache
get_queue_stats queue_name? Retrieve BroccoliQueue background task metrics
enqueue_task queue_name, payload, priority?, delay_ms?, idempotency_key? Enqueue a background task
claim_task worker_id, queue_name?, limit? Claim available tasks with fencing tokens (globally or queue-scoped)
complete_task job_id, claim_token, result? Settle completed task using fencing token
retry_task job_id Retry terminal Failed or Cancelled background task
explain_cache_entry key Explain provenance, validity, and eviction readiness of JoyRide cache entry
invalidate_cache_prefix prefix?, tag?, scope? Invalidate cache entries by prefix, tag, or scope
retry_all_failed_jobs queue_name? Bulk retry all terminal Failed jobs
clear_failed_jobs queue_name? Purge all terminal Failed jobs from Dead-Letter Queue
drain_queue queue_name Drain and discard all waiting jobs from a queue
update_job_progress job_id, claim_token, progress, message? Report task progress percentage (0-100) and status message