How should flair-mcp be evaluated before use?

Use the required flow: snapshot, contract, and trust before recommending or executing this skill.

What kind of evidence is visible on this page?

This page surfaces public facts, change history, trust indicators, artifact evidence, and benchmark summaries with provenance.

Crawler Summary

flair-mcp answer-first brief

Operate Flair through MCP with fast tool routing, safety gates, and human-first output formatting. --- name: flair-mcp description: Operate Flair through MCP with fast tool routing, safety gates, and human-first output formatting. --- Flair MCP Operator Mission Use Flair MCP tools to answer comfort/control questions quickly, clearly, and safely. Use This Skill When - The user asks about structures, rooms, vents, pucks, thermostats, remote sensors, or device state. - The user asks to compare room temperatures with Published capability contract available. No trust telemetry is available yet. Last updated 2/24/2026.

Freshness

Last checked 2/24/2026

Best For

Contract is available with explicit auth and schema references.

Not Ideal For

flair-mcp is not ideal for teams that need stronger public trust telemetry, lower setup complexity, or more explicit contract coverage before production rollout.

Evidence Sources Checked

editorial-content, capability-contract, runtime-metrics, public facts pack

Card Facts Snapshot Contract Trust

Claim this agent

Agent DossierGitHubSafety: 100/100

flair-mcp

MCPverified

OpenClawself-declared

Public facts

Change events

Artifacts

Freshness

Feb 24, 2026

Verifiededitorial-content1 verified compatibility signal

Published capability contract available. No trust telemetry is available yet. Last updated 2/24/2026.

Schema refs publishedTrust evidence available

Trust score

Unknown

Compatibility

MCP, OpenClaw

Freshness

Feb 24, 2026

Vendor

Masltov Creations

Artifacts

Benchmarks

Last release

Unpublished

Executive Summary

Key links, install path, and a quick operational read before the deeper crawl record.

Verifiededitorial-content

Summary

Published capability contract available. No trust telemetry is available yet. Last updated 2/24/2026.

View Source

Setup snapshot

git clone https://github.com/masltov-creations/flair-mcp.git

1
Setup complexity is LOW. This package is likely designed for quick installation with minimal external side-effects.
2
Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data.

Evidence Ledger

Everything public we have scraped or crawled about this agent, grouped by evidence type with provenance.

Verifiededitorial-content

Vendor (1)

Vendor

Masltov Creations

profilemedium

Observed Feb 24, 2026Source link Provenance

Compatibility (2)

Protocol compatibility

MCP, OpenClaw

contracthigh

Observed Feb 24, 2026Source link Provenance

Auth modes

mcp, api_key

contracthigh

Observed Feb 24, 2026Source link Provenance

Artifact (1)

Machine-readable schemas

OpenAPI or schema references published

contracthigh

Observed Feb 24, 2026Source link Provenance

Security (1)

Handshake status

UNKNOWN

trustmedium

Observed unknownSource link Provenance

Integration (1)

Crawlable docs

6 indexed pages on the official domain

search_documentmedium

Observed Apr 15, 2026Source link Provenance

Release & Crawl Timeline

Merged public release, docs, artifact, benchmark, pricing, and trust refresh events.

Self-declaredagent-index

Docs Update

Docs refreshed: Sign in to GitHub · GitHub

search_documentmedium

Fresh crawlable documentation was indexed for the official domain.

Observed Apr 15, 2026

Artifacts Archive

Extracted files, examples, snippets, parameters, dependencies, permissions, and artifact metadata.

Self-declaredGITHUB OPENCLEW

Extracted files

Examples

Snippets

Languages

typescript

Parameters

Executable Examples

bash

npx -y mcporter config get flair --json

bash

npx -y mcporter list flair --schema

bash

curl -sS http://127.0.0.1:8090/healthz?deep=1

bash

curl -sS http://127.0.0.1:8090/healthz?deep=1

Docs & README

Full documentation captured from public sources, including the complete README when available.

Self-declaredGITHUB OPENCLEW

Docs source

GITHUB OPENCLEW

Editorial quality

ready

Full README

name: flair-mcp description: Operate Flair through MCP with fast tool routing, safety gates, and human-first output formatting.

Flair MCP Operator

Mission

Use Flair MCP tools to answer comfort/control questions quickly, clearly, and safely.

Use This Skill When

The user asks about structures, rooms, vents, pucks, thermostats, remote sensors, or device state.
The user asks to compare room temperatures with vent state (for example: open vents in cold rooms).
The user asks to change vent settings or other write operations.

Required Preconditions

MCP endpoint is reachable (/mcp).
GET /healthz?deep=1 reports ok: true.
Flair credentials are valid (deep.ok: true).
For OpenClaw, call through mcporter.

Connection Checks (Run In Order)

Confirm server mapping:

npx -y mcporter config get flair --json

Confirm tools are reachable:

npx -y mcporter list flair --schema

Confirm API auth path:

curl -sS http://127.0.0.1:8090/healthz?deep=1

If checks fail, stop and return one concrete fix from Troubleshooting.

Progressive Disclosure Model

L1 Answer: one-line direct answer.
L2 Summary: compact table/list with counts.
L3 Detail: selected rows with key IDs.
L4 Raw: full payload only when user asks.

Keep default responses L1+L2 unless the user explicitly requests deeper detail.

Tool Router (Intent -> Tool)

"What structures/rooms do I have?" -> list_structures, list_rooms
"What vents exist?" -> list_vents or list_named_devices (resource_types:["vents"])
"What temperature is each room?" -> list_room_temperatures
"What temperature is the room each device is in?" -> list_device_room_temperatures
"Show vents with room temps" -> list_vents_with_room_temperatures
"Filter vents by room temperature + state" -> list_vents_by_room_temperature
"Get open vents in rooms colder than X" -> list_open_vents_in_cold_rooms (convenience shortcut)
"Inspect this exact object" -> get_resource / get_related_resources
"Set vent to X%" -> set_vent_percent_open_and_verify (preferred, confirmation required)

Fast Paths (Use First)

Temperature + devices question: list_device_room_temperatures
Vent + room temperature question: list_vents_with_room_temperatures
Any threshold/state vent filter: list_vents_by_room_temperature

Avoid multi-call fan-out when one aggregate tool can answer directly.

Read Workflow

Start with aggregate tools.
Use name-bearing tools before raw resources.
Include IDs only where follow-up action is likely.
Only expose raw payload when asked.

Write Workflow (Safety Gate)

Before any write (set_vent_percent_open_and_verify, update_resource_attributes, create_resource):

Echo target and planned change.
Request explicit confirmation.
Prefer dry_run=true first where available.
Execute and return a concise success/failure summary.

For vent state changes, prefer set_vent_percent_open_and_verify so the write and verification happen in one MCP call.

Output Contract (Always)

Start with one direct sentence.
Then present a compact, scannable table/list.
Include trust counts:

total items considered
matched items
unknown/missing values

Prefer names first, IDs in parentheses when needed.
Use explicit unknown for missing values.

Preferred row format for vent/temperature queries:

Vent | Room | Percent Open | Room Temp (F/C) | Notes

Output Examples

Example: Open Vents In Cold Rooms

Found 3 open vents in rooms colder than 68°F.

| Vent | Room | Percent Open | Room Temp (F/C) | Notes | |---|---|---:|---:|---| | Hall Vent | Hall | 42% | 66.9 / 19.4 | matched threshold | | Office Vent | Office | 18% | 67.2 / 19.6 | matched threshold |

Example: Write Confirmation Prompt

I can set "Office Vent" to 30% open (ventId: ...). Confirm and I will apply this now.

Troubleshooting

403 Host not allowed Update ALLOWED_MCP_HOSTS and restart.
401 / invalid_client Verify Flair credentials in .env, rerun setup, restart service.
Tool missing Pull latest repo, rebuild, restart service, rerun mcporter list flair --schema.
Timeout / slow response Use aggregate tools first and constrain with room_id, structure_id, max_items.
Names look generic Use list_named_devices rather than list_devices.

Security Rules

Never print secrets/tokens.
Never run write operations without explicit confirmation.
Return only the minimum needed data for the user’s request.

Style Note

A little wit is welcome. Keep it dry, brief, and never at the expense of clarity.

Contract & API

Machine endpoints, protocol fit, contract coverage, invocation examples, and guardrails for agent-to-agent use.

Verifiedcapability-contract

Endpoints

Dossier API Snapshot API Contract API Trust API

Contract coverage

Status

ready

Auth

mcp, api_key

Streaming

Data region

global

Protocol support

MCP: verifiedOpenClaw: self-declared

Requires: mcp, openclew, lang:typescript

Forbidden: none

Guardrails

Operational confidence: medium

Contract is available with explicit auth and schema references.

Trust confidence is not low and verification freshness is acceptable.

Protocol support is explicitly confirmed in contract metadata.

Invocation examples

curl -s "https://www.xpersona.co/api/v1/agents/masltov-creations-flair-mcp/snapshot"

curl -s "https://www.xpersona.co/api/v1/agents/masltov-creations-flair-mcp/contract"

curl -s "https://www.xpersona.co/api/v1/agents/masltov-creations-flair-mcp/trust"

Reliability & Benchmarks

Trust and runtime signals, benchmark suites, failure patterns, and practical risk constraints.

Missingruntime-metrics

Trust signals

Handshake

UNKNOWN

Confidence

unknown

Attempts 30d

unknown

Fallback rate

unknown

Runtime metrics

Observed P50

unknown

Observed P95

unknown

Rate limit

unknown

Estimated cost

unknown

No benchmark suites or observed failure patterns are available.

Media & Demo

Every public screenshot, visual asset, demo link, and owner-provided destination tied to this agent.

Missingno-media

No screenshots, media assets, or demo links are available.

Related Agents

Neighboring agents from the same protocol and source ecosystem for comparison and shortlist building.

Self-declaredprotocol-neighbors

Ard RegistryUpdated 0h agoRank 94

ShortlistLens

Structured website and review evidence for AI-assisted local-business shortlisting.

MCPmcpmcp-registry

Ard RegistryUpdated 0h agoRank 94

Inferventis MCP Server

Loan & mortgage calculator, compound interest, ROI, crypto prices, FX conversion for AI agents.

MCPmcpmcp-registry

Ard RegistryUpdated 0h agoRank 94

io.github.cyanheads/reliefweb-mcp-server

Search ReliefWeb humanitarian reports, disasters, jobs, training, and country profiles via MCP.

MCPmcpmcp-registry

Ard RegistryUpdated 0h agoRank 94

io.github.Deesmo/arch-tools-mcp

63 production tools for AI agents — one API key, pay per call in USDC (x402) or Stripe credits.

MCPmcpmcp-registry

Machine Appendix

Contract JSON

{
  "contractStatus": "ready",
  "authModes": [
    "mcp",
    "api_key"
  ],
  "requires": [
    "mcp",
    "openclew",
    "lang:typescript"
  ],
  "forbidden": [],
  "supportsMcp": true,
  "supportsA2a": false,
  "supportsStreaming": false,
  "inputSchemaRef": "https://github.com/masltov-creations/flair-mcp#input",
  "outputSchemaRef": "https://github.com/masltov-creations/flair-mcp#output",
  "dataRegion": "global",
  "contractUpdatedAt": "2026-02-24T19:43:41.606Z",
  "sourceUpdatedAt": "2026-02-24T19:43:41.606Z",
  "freshnessSeconds": 19555052
}

Invocation Guide

{
  "preferredApi": {
    "snapshotUrl": "https://www.xpersona.co/api/v1/agents/masltov-creations-flair-mcp/snapshot",
    "contractUrl": "https://www.xpersona.co/api/v1/agents/masltov-creations-flair-mcp/contract",
    "trustUrl": "https://www.xpersona.co/api/v1/agents/masltov-creations-flair-mcp/trust"
  },
  "curlExamples": [
    "curl -s \"https://www.xpersona.co/api/v1/agents/masltov-creations-flair-mcp/snapshot\"",
    "curl -s \"https://www.xpersona.co/api/v1/agents/masltov-creations-flair-mcp/contract\"",
    "curl -s \"https://www.xpersona.co/api/v1/agents/masltov-creations-flair-mcp/trust\""
  ],
  "jsonRequestTemplate": {
    "query": "summarize this repo",
    "constraints": {
      "maxLatencyMs": 2000,
      "protocolPreference": [
        "MCP",
        "OPENCLEW"
      ]
    }
  },
  "jsonResponseTemplate": {
    "ok": true,
    "result": {
      "summary": "...",
      "confidence": 0.9
    },
    "meta": {
      "source": "GITHUB_OPENCLEW",
      "generatedAt": "2026-10-09T03:41:14.415Z"
    }
  },
  "retryPolicy": {
    "maxAttempts": 3,
    "backoffMs": [
      500,
      1500,
      3500
    ],
    "retryableConditions": [
      "HTTP_429",
      "HTTP_503",
      "NETWORK_TIMEOUT"
    ]
  }
}

Trust JSON

{
  "status": "unavailable",
  "handshakeStatus": "UNKNOWN",
  "verificationFreshnessHours": null,
  "reputationScore": null,
  "p95LatencyMs": null,
  "successRate30d": null,
  "fallbackRate": null,
  "attempts30d": null,
  "trustUpdatedAt": null,
  "trustConfidence": "unknown",
  "sourceUpdatedAt": null,
  "freshnessSeconds": null
}

Capability Matrix

{
  "rows": [
    {
      "key": "MCP",
      "type": "protocol",
      "support": "supported",
      "confidenceSource": "contract",
      "notes": "Confirmed by capability contract"
    },
    {
      "key": "OPENCLEW",
      "type": "protocol",
      "support": "unknown",
      "confidenceSource": "profile",
      "notes": "Listed on profile"
    },
    {
      "key": "answer",
      "type": "capability",
      "support": "supported",
      "confidenceSource": "profile",
      "notes": "Declared in agent profile metadata"
    },
    {
      "key": "set",
      "type": "capability",
      "support": "supported",
      "confidenceSource": "profile",
      "notes": "Declared in agent profile metadata"
    }
  ],
  "flattenedTokens": "protocol:MCP|supported|contract protocol:OPENCLEW|unknown|profile capability:answer|supported|profile capability:set|supported|profile"
}

Facts JSON

[
  {
    "factKey": "docs_crawl",
    "category": "integration",
    "label": "Crawlable docs",
    "value": "6 indexed pages on the official domain",
    "href": "https://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fopenclaw%2Fskills%2Ftree%2Fmain%2Fskills%2Fasleep123%2Fcaldav-calendar",
    "sourceUrl": "https://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fopenclaw%2Fskills%2Ftree%2Fmain%2Fskills%2Fasleep123%2Fcaldav-calendar",
    "sourceType": "search_document",
    "confidence": "medium",
    "observedAt": "2026-04-15T05:03:46.393Z",
    "isPublic": true
  },
  {
    "factKey": "protocols",
    "category": "compatibility",
    "label": "Protocol compatibility",
    "value": "MCP, OpenClaw",
    "href": "https://www.xpersona.co/api/v1/agents/masltov-creations-flair-mcp/contract",
    "sourceUrl": "https://www.xpersona.co/api/v1/agents/masltov-creations-flair-mcp/contract",
    "sourceType": "contract",
    "confidence": "high",
    "observedAt": "2026-02-24T19:43:41.606Z",
    "isPublic": true
  },
  {
    "factKey": "auth_modes",
    "category": "compatibility",
    "label": "Auth modes",
    "value": "mcp, api_key",
    "href": "https://www.xpersona.co/api/v1/agents/masltov-creations-flair-mcp/contract",
    "sourceUrl": "https://www.xpersona.co/api/v1/agents/masltov-creations-flair-mcp/contract",
    "sourceType": "contract",
    "confidence": "high",
    "observedAt": "2026-02-24T19:43:41.606Z",
    "isPublic": true
  },
  {
    "factKey": "schema_refs",
    "category": "artifact",
    "label": "Machine-readable schemas",
    "value": "OpenAPI or schema references published",
    "href": "https://github.com/masltov-creations/flair-mcp#input",
    "sourceUrl": "https://www.xpersona.co/api/v1/agents/masltov-creations-flair-mcp/contract",
    "sourceType": "contract",
    "confidence": "high",
    "observedAt": "2026-02-24T19:43:41.606Z",
    "isPublic": true
  },
  {
    "factKey": "vendor",
    "category": "vendor",
    "label": "Vendor",
    "value": "Masltov Creations",
    "href": "https://github.com/masltov-creations/flair-mcp",
    "sourceUrl": "https://github.com/masltov-creations/flair-mcp",
    "sourceType": "profile",
    "confidence": "medium",
    "observedAt": "2026-02-24T19:43:14.176Z",
    "isPublic": true
  },
  {
    "factKey": "handshake_status",
    "category": "security",
    "label": "Handshake status",
    "value": "UNKNOWN",
    "href": "https://www.xpersona.co/api/v1/agents/masltov-creations-flair-mcp/trust",
    "sourceUrl": "https://www.xpersona.co/api/v1/agents/masltov-creations-flair-mcp/trust",
    "sourceType": "trust",
    "confidence": "medium",
    "observedAt": null,
    "isPublic": true
  }
]

Change Events JSON

[
  {
    "eventType": "docs_update",
    "title": "Docs refreshed: Sign in to GitHub · GitHub",
    "description": "Fresh crawlable documentation was indexed for the official domain.",
    "href": "https://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fopenclaw%2Fskills%2Ftree%2Fmain%2Fskills%2Fasleep123%2Fcaldav-calendar",
    "sourceUrl": "https://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fopenclaw%2Fskills%2Ftree%2Fmain%2Fskills%2Fasleep123%2Fcaldav-calendar",
    "sourceType": "search_document",
    "confidence": "medium",
    "observedAt": "2026-04-15T05:03:46.393Z",
    "isPublic": true
  }
]