🎁 Get the FREE AI Skills Starter Guide β€” Subscribe β†’
BytesAgainBytesAgain
BytesAgain β€Ί Skills β€Ί Hemlane MCP
πŸ¦€ ClawHub

Hemlane MCP

by @earlvanze

Operate Hemlane using HAR-derived GraphQL patterns and browser session artifacts. Use when analyzing Hemlane HAR files, extracting GraphQL operations from He...

Versionv0.2.0
Downloads472
#crypto-defi#api#legal
TERMINAL
clawhub install hemlane

πŸ“– About This Skill

name: hemlane description: Operate Hemlane using HAR-derived GraphQL patterns and browser session artifacts. Use when analyzing Hemlane HAR files, extracting GraphQL operations from Hemlane traffic, documenting Hemlane mutations/queries, or performing/reconstructing Hemlane workflows like referrals, tenant replies, work orders, transactions, requests, and maintenance updates from saved browser captures.

Hemlane

Use this skill for Hemlane reverse-engineering and repeatable browser-captured workflows.

Included HAR coverage

Read references/har-summary.md first when you need a quick map of what the saved Hemlane HAR files contain.

Saved flows consolidated into this skill:

  • refer_hemlane.com.har
  • tenant-reply_hemlane.com.har
  • work-order_hemlane.com.har
  • requests_hemlane.com.har
  • transactions_hemlane.com.har
  • maintenance_update_hemlane.com.har
  • financials_hemlane.com.har (runtime capture at ~/Downloads/har; summarized in references/financials-har-summary.md)

    • Default workflow

    1. Identify which business action is needed: referral, tenant reply, work order, requests, transactions, or maintenance update. 2. Read references/har-summary.md to find the closest HAR. 3. Read references/graphql-operations.md to find the relevant GraphQL operation names, variables, and query excerpts. 4. If you need fresh extraction or normalization from HAR files, use scripts/extract_hemlane_graphql.py. 5. Prefer reconstructing stable GraphQL requests over brittle browser clicking. 6. Preserve auth and CSRF requirements; never hardcode secrets into the skill.

    Auth rules

  • Treat cookies, bearer tokens, CSRF tokens, and session identifiers as runtime secrets.
  • Do not store live tokens in SKILL.md or references.
  • Use env vars or ephemeral local files when replaying captured requests.

    • CDP Auth Capture

    Use scripts/capture_hemlane_auth_via_cdp.py to capture fresh auth headers from an authenticated Brave browser session via CDP.

    Requirements

  • Brave running with remote debugging enabled (--remote-debugging-port=9222)
  • Authenticated Hemlane session in browser

    • Usage

    python3 skills/hemlane/scripts/capture_hemlane_auth_via_cdp.py \
  --endpoint-kind get-properties \
  --out-file /tmp/hemlane-auth.json

    Endpoint Kinds

  • get-properties - Property list
  • get-tenants - Tenant list
  • get-transactions - Financial transactions
  • get-maintenance - Maintenance requests
  • send-tenant-reply - Tenant messaging
  • submit-referral - HubSpot referral form
  • work-order-comment - Work order comments
  • maintenance-comment - Maintenance comments

    • MCP Server

    Hemlane MCP server provides tools for common operations via MCP protocol.

    Location

    mcp/server.py - FastMCP server wrapping existing scripts

    Tools Provided

  • capture_auth - Capture auth headers from browser CDP
  • send_tenant_reply - Send tenant reply
  • submit_referral - Submit referral
  • post_workorder_comment - Post work order comment
  • post_maintenance_comment - Post maintenance comment
  • extract_rent_roll - Extract rent roll data
  • query_recurring_payment_requests - Query active/expired recurring rent/payment requests from Financials HAR
  • query_financials_operation - Replay read-oriented Financials GraphQL operations from financials HAR samples, including page navigation
  • list_graphql_operations - List available GraphQL ops

    • Configuration

    Added to config/mcporter.json: 
    {
  "mcpServers": {
    "hemlane": {
      "command": "python3",
      "args": ["/home/umbrel/.openclaw/workspace/skills/hemlane/mcp/server.py"],
      "transport": "stdio"
    }
  }
}

    What this skill is good for

  • Turning multiple Hemlane HAR files into one operational reference
  • Discovering GraphQL operation names and variable shapes
  • Rebuilding Hemlane API requests from captured browser traffic
  • Standardizing future Hemlane automations into one place

    • Files

  • references/har-summary.md - per-HAR inventory and auth header observations
  • references/graphql-operations.md - extracted GraphQL operations and sample variable payloads
  • scripts/extract_hemlane_graphql.py - reusable extractor for future HAR files
  • scripts/capture_hemlane_auth_via_cdp.py - CDP auth capture from browser
  • mcp/server.py - MCP server for tool access
  • references/operation-catalog.json and references/operation-catalog.csv - clean operation catalog exports
  • references/runbooks.md - explicit runbooks for referral submit, tenant reply, maintenance/work-order comment, and transaction lookup
  • references/*.har - preserved original Hemlane HAR captures
  • scripts/build_hemlane_catalog.py - regenerate catalog from HAR files

    • Replay scaffold

    Use references/replay-scaffold.md and scripts/replay_hemlane_graphql.py when you need to move from HAR analysis to safe request replay. Start with --dry-run and provide cookies/CSRF via env vars only.

    Task-level wrappers

    Use these wrappers for the highest-value Hemlane workflows before dropping down to the generic replay scaffold:
  • scripts/submit_hemlane_referral.py
  • scripts/post_hemlane_workorder_comment.py
  • scripts/post_hemlane_maintenance_request_comment.py
  • scripts/send_hemlane_tenant_reply.py
  • scripts/capture_hemlane_auth_via_cdp.py

    • Lease Generation Mutations

    Captured from lease_hemlane.com.har:

    | Operation | Type | Purpose | |-----------|------|---------| | ODCreateLeaseAgreement | Mutation | Create lease agreement for tenant group | | ODCreateLeaseAgreementTemplate | Mutation | Create e-sign packet from lease | | ODLeaseAgreementRevertEsignPacket | Mutation | Revert/cancel e-sign packet |

    Create Lease Agreement

    mutation ODCreateLeaseAgreement($input: LeaseAgreementCreateInput!) {
  leaseAgreementCreate(input: $input) {
    error
    leaseAgreement {
      id
      status
      tenantGroup { id }
      survey
      createdAt
    }
  }
}

    Variables:

  • tenantGroupId (required) - The tenant group ID
  • survey (optional) - Additional disclosures, etc.

    • Create E-Sign Packet

    mutation ODCreateLeaseAgreementTemplate($input: EsignDocumentCreateLeaseAgreementTemplateInput!) {
  esignDocumentCreateLeaseAgreementTemplate(input: $input) {
    error
    esignPacket {
      id
      sourceSignable { ... on LeaseAgreement { id status } }
    }
  }
}

    Wrapper Script

    Use scripts/create_hemlane_lease.py for lease generation:

    python3 scripts/create_hemlane_lease.py \
  --tenant-group-id "53cf1ff2-56d7-41e5-a0bd-9d3cc2a99aab" \
  --auth-file /tmp/hemlane-auth.json \
  --create-esign

    Files Added

  • references/lease-mutations.graphql - Lease generation mutations
  • scripts/create_hemlane_lease.py - Lease creation wrapper

    • New MCP read tools (2026-05-01)

    HAR-derived read wrappers added to mcp/server.py:

  • query_catalog_operation β€” generic read-only replay from references/operation-catalog.json; refuses mutations/write-like operations.
  • get_context_values β€” wraps ODGetContextValues for owner dashboard context/properties.
  • get_tenant_groups β€” wraps ODTenantsAndLeasesTenantGroups for tenant/lease views.
  • get_maintenance_requests β€” wraps ODMaintenanceRequests.
  • get_transactions β€” wraps TransactionsNextCursorQuery using the financials replay script.

    • See README.md for setup, auth model, and HAR reverse-engineering workflow.

    πŸ’‘ Examples

    python3 skills/hemlane/scripts/capture_hemlane_auth_via_cdp.py \
  --endpoint-kind get-properties \
  --out-file /tmp/hemlane-auth.json

    Endpoint Kinds

  • get-properties - Property list
  • get-tenants - Tenant list
  • get-transactions - Financial transactions
  • get-maintenance - Maintenance requests
  • send-tenant-reply - Tenant messaging
  • submit-referral - HubSpot referral form
  • work-order-comment - Work order comments
  • maintenance-comment - Maintenance comments

    • βš™οΈ Configuration

    Added to config/mcporter.json: 

    {
  "mcpServers": {
    "hemlane": {
      "command": "python3",
      "args": ["/home/umbrel/.openclaw/workspace/skills/hemlane/mcp/server.py"],
      "transport": "stdio"
    }
  }
}