Skip to main content
Glama

Server Details

Control your existing Philips lights, Sonos speakers, Roborock vacuums and other supported devices through Port OS cloud. Give ChatGPT, Claude and other MCP-compatible assistants access to the devices you connect.

Turn off the living room lights, play music on your speakers, adjust the thermostat, run a vacuum in a room, check a camera snapshot or find a connected tracker. Available actions depend on your linked provider accounts and each device’s supported capabilities.

Port OS runs in the cloud; no local server is required. You choose the account, device and capability permissions each assistant receives. Device operations require user OAuth; public tool discovery does not grant device access.

Port OS is in alpha. Setup: https://portoperatingsystem.com/docs/getting-started/ Support: https://portoperatingsystem.com/contact/

If you are the author of this connector, you can claim ownership by verifying the domain or GitHub account it belongs to. Claimed connector authors can inspect health checks, view analytics, and manage their listing.
Status
Healthy
Uptime
100.0% over the last 24 hours
OAuth
Works in Glama
Last Tested
Transport
Streamable HTTP · MCP 2025-11-25
URL
ChatGPT
–
Claude
–

TDQS

A4.1/5.0

Scored across 10 tools

Disambiguation4/5

Tools are mostly cleanly separated by resource and action: control sends device commands, endpoint/group manage tools edit registry data, query tools discover state, and subscription tools have distinct lifecycle operations. The main overlap is endpoint_query versus endpoint_show, since both can select/expand endpoints and return readings, so an agent may occasionally choose the wrong read path.

Naming Consistency4/5

Most names follow a predictable resource_action snake_case pattern, such as endpoint_query, group_manage, subscription_list, and subscription_cancel. The bare verb 'control' is the main deviation, but it remains readable and does not disrupt the overall convention.

Tool Count5/5

Ten tools is well-scoped for a smart-home server covering discovery, control, endpoint metadata, group management, and subscription administration. Each tool has a clear role, and the set avoids unnecessary granular tools by using a generic control dispatcher.

Completeness4/5

The set covers the core lifecycle for endpoints and groups: discover, read state, control, manage metadata, and inspect/manage subscriptions. There are minor gaps, notably no subscription creation tool and reliance on the host's events/subscribe capability, plus media and scene workflows that are described only as message recipes rather than dedicated tools.

Publisher details

Operator
Mirumiru inc. · Publisher source
Vendor relationship
First-party
Privacy policy
Not provided
Restrictions
none · Publisher source

Available Tools

10 tools
controlA
DestructiveIdempotent
Inspect

Control devices/services.

Dispatch a declared message with the payload its discovery entry shows ({} if fieldless) to one discovered logical id or endpoint_query-style query. Control only sends device messages; read with endpoint_query or group_query. Query values are operator objects: {"type":{"in":["LIGHT","SWITCH"]}}, never {"type":"LIGHT"}. Named devices, including dim/color, require their endpoint; groups require room/group intent. Unqualified vacuum start is whole-device. Queries freeze 1-100 authorized matches; zero/over-limit sends nothing. Copy references/account; Port OS selects routes.

Whole-home lights: one complete lighting query; rooms: resolved lighting group. Query adds no exclusions. Include switches/plugs whose names indicate lamps; exclude appliances, fans, catalogs and duplicates; simulated devices count like any other. Discover missing scope only; report unresolved coverage. Dim/brighten: adjust-brightness {"brightnessDelta":-25} where declared; otherwise read brightness first and set a value below (dim) or above (brighten) it. Lights that are all off cannot dim: say so. Blind lift is percent open: open is liftPercent100thsValue 10000, closed 0.

Commands: waitForResult=false for ordinary commands; a message whose own description asks for waitForResult true gets it (for example remote-control start-session/move: SUCCEEDED means the robot finished, false only returns QUEUED), then verify with endpoint_query expand spatial plus forceDeviceAttributeQuery:true; a move with no pose change was ignored. Otherwise acknowledge accepted/pending and stop, without auto-poll/read/card. State/settings: endpoint_query with expand and forceDeviceAttributeQuery:true. Replies (snapshots, SDP, searches, queues, scene creation, authorization challenges): wait true. A snapshot image arrives as a separate image content block in the tool result, not in the structured body. Empty QUEUED/IN_PROGRESS remains pending; acceptance proves no physical state. Exception: after play-media or launch-application on a TELEVISION, confirm once before saying it plays (an app can stop on a profile picker): endpoint_query forceDeviceAttributeQuery:true, or snapshot/get-snapshot {"responseFormat":"BASE64"} (the default URL cannot be viewed), and follow the TV description if it is stuck.

Tools-only recipes: media-search/search-media {"query":"","type":"track"} (type is lower case; supportedSearchTypes lists TRACK upper case); media-queue/play-queue {"mediaIds":[""]}; get-queue {}; add-to-queue {"mediaId":""}, plus fresh queueVersion only when requiresQueueVersion=true. Match declared resources/bounds. Queue differs from saved playlist; failed search proves no state. Scenes: group_query expand:["scene"], forceDeviceAttributeQuery:true; scene/activate {"sceneId":""}; scene/create-scene {"name":""} captures current settings ("like this" means as they are now; change no light first), wait true, only on a group whose messages list it; otherwise change nothing and say saving is unsupported. Recover uncertain creation before another write. Full workflows: skills or portos://guides/index.

New action: new idempotencyKey; copy caller keys exactly. Never auto-repeat TIMED_OUT/ambiguous failure (including 404): without a receipt, the same key can dispatch anew. Recover authorized receipt/fresh state; authorized retry retains all arguments/key/wait mode. MESSAGE_UNSUPPORTED/MESSAGE_AMBIGUOUS sent nothing: correct from discovery. Inspect partial/errors; unreachable rejected delivery, conflicting observations prove no success. Inventory: management tools.

Inputs: message (required), payload (required), idempotencyKey (required), id, +3 more. Returns: object

endpoint_manageA
DestructiveIdempotent
Inspect

Edit endpoint registry metadata; physical actions use control. Read endpoint ID, document and etag first. Metadata replacement requires complete name/type/enablement, etag and idempotencyKey; rename/type/disabled state survives rediscovery. Disabled endpoints remain explicitly readable but reject controls. DELETE may be rediscovered.

MERGE_INTO disables the source and moves supported references; it creates no ID alias and preserves target enablement. Two simulator endpoints cannot merge (409 CONFLICT); disable/delete the duplicate instead. Confirm exact identity and explain MERGE_INTO/DELETE effects; matching names do not prove duplicates.

Inputs: etag (required), operation (required), endpointId (required), idempotencyKey (required), +5 more. Returns: object

endpoint_queryA
Read-onlyIdempotent
Inspect

Find devices/services, declarations and observations. Filter by name/type/capability; follow paginationContext.nextToken for the requested scope. endpointId reads one known endpoint and takes no query, maxResults or nextToken. Copy returned references/account; Port OS selects routes. Use group_query for rooms and management tools for inventory edits.

State reads require declared expand capabilities and forceDeviceAttributeQuery=true. FRESH is current; STALE is last known with sampledAt and cannot support a safety claim. Missing/invalid/errored/PROVIDER_NO_STATE is unknown; PROVIDER_NO_STATE is not offline and retries cannot supply an absent provider value. FRESH UNREACHABLE is offline; STALE connectivity is last known. ID-only lookup reads metadata; an expanded read returns only the expanded capabilities, without the description. simulator:true means all routes are synthetic; routes[].simulator marks mixed routes. Missing flags are unknown. Treat simulated endpoints like any other device.

Types alone do not identify lamps: nothing marks a switch/plug as lighting, so infer it from names and rooms and clarify when unclear. Temperature setpoints are distinct from ambient readings; clarify indoor/outdoor ambiguity. Check relevant authorized accounts before reporting absence; names alone prove no identity. Select concrete route-backed services, not provider catalogs or obsolete unrouted entries. Default lists include ENABLED; DISABLED or * selects others. Exact endpointId can read disabled metadata. An endpoint does not list its rooms: find them with group_query. Device workflows and payloads: matching Port OS skill or portos://guides/index.

Inputs: query, expand, nextToken, enablement, +3 more. Returns: object

endpoint_showA
Read-onlyIdempotent
Inspect

Open the Port OS device UI when requested; never draw a second card/map/controls. Answer with the relevant value in words. This tool shares endpoint_query selection, expand and pagination. One matching endpoint opens controls; multiple matches open a selection list. It sends no control and starts no live video.

primary selects a returned cardId (for example battery, fan, closure, camera, location or house-map) and refreshes its readings; unsupported IDs return available choices. Other cards remain in details. Results include cached readings for listed cards, so avoid a second read. FRESH is current; STALE is last known with its age. Ordinary commands require no automatic UI follow-up.

Inputs: query, expand, primary, nextToken, +4 more. Returns: object

group_manageA
DestructiveIdempotent
Inspect

Create/rename/delete groups, change members/enablement or merge inventory; physical actions use control. Read IDs/etags first. Every batch reference to a group uses its starting etag. MOVE_MEMBER needs memberEndpointId plus source/target IDs and both etags. List order cannot resolve contradictory edits; adding does not implicitly move exclusive membership.

Native-capable changes default to BEST_EFFORT: provider change/readback precedes local intent; failure can fall back locally as PARTIALLY_APPLIED. PORTOS_ONLY sends nothing. FAIL_ON_PROVIDER_ERROR fails intent while retaining received provider facts. Native effects cannot roll back. NOT_DECLARED alone is not partial; OUTSIDE_PRINCIPAL prevents native changes through another principal. MERGE_INTO and aggregate/route enablement require PORTOS_ONLY.

Require explicit user authorization for exact MERGE_INTO/DELETE_GROUP targets/effects. Deletion may delete native groups; unretired routes stay disabled/orphaned against rediscovery. Route enablement needs its native etag and groupEtag when grouped. Use declared provider support; robot room edits do not reshape maps.

validateOnly=true authorizes/plans without sending/writing. Otherwise use a unique idempotencyKey per intent; identical retries retain it. Stale etag: reread/reconsider. Inspect batch status, per-item outcomes and providerDispatches, including on failure. Failed intent can retain provider changes; never claim full synchronization or automatically repeat native writes.

Inputs: operations (required), validateOnly, idempotencyKey. Returns: object

group_queryA
Read-onlyIdempotent
Inspect

Find rooms/groups with IDs, etags, hierarchy, members, controllers, providers and messages. Query by name; follow pages; disambiguate by parentPath. Pages omit route declarations; id reads one group with them and payload shapes; merged IDs return redirectedFrom. Copy IDs/etags.

Use control on the complete logical group; Port OS selects native/equivalent member delivery. Native capabilities/membershipComplete prove no aggregate coverage. membershipComplete=false means incomplete; absent means unknown. Empty resolved members do not prove an empty native group. Disabled routes cannot control; disabled groups need re-enablement through group_manage.

Controllers accept group-scoped actions: to clean a room, find the room group by name, read its controllers (endpointId and the messages each accepts, such as clean-room), then control that vacuum with {"groupIds":[""]}. To list a vacuum's rooms, query {"controllers": {"has": ""}}. Requested maps use endpoint_show on that controller, primary house-map; never draw geometry. expand selects observations; forceDeviceAttributeQuery refreshes them. Omitted/failed fresh values are unavailable. Disabled groups are hidden unless enablement=DISABLED or *.

Inputs: id, query, expand, nextToken, +3 more. Returns: object

subscription_cancelA
DestructiveIdempotent
Inspect

Stop watching by cancelling one Port OS event subscription using its exact ID from subscription_list or subscription_inspect.

Cancellation is idempotent. Select the intended subscription by name, source endpoint and catalog event; names are not cancellation keys. A stopped monitor requires a new subscription to watch again.

Inputs: id (required), ifMatch (required), idempotencyKey (required). Returns: object

subscription_inspectA
Read-onlyIdempotent
Inspect

Inspect one Port OS event subscription by its exact ID returned by subscription_list.

Returns its safe query, source endpoint, catalog name and lifecycle status. A retained active subscription establishes registration; it does not prove that any client has received or acted on a camera event.

Inputs: id (required). Returns: object

subscription_label_editA
Idempotent
Inspect

Change only the display name of one Port OS event subscription by exact ID.

Use a PLAIN name-value object. The event, endpoint, filter and destination are immutable; to change what is watched, establish a replacement monitor and cancel the old ID.

Inputs: id (required), name (required), ifMatch (required), idempotencyKey (required). Returns: object

subscription_listA
Read-onlyIdempotent
Inspect

Enumerate the user's Port OS event subscriptions, including their exact IDs, names, source endpoint, catalog event and status.

For requests to stop watching a camera, list subscriptions and follow every nextCursor, select the intended monitor, then use subscription_cancel with its exact ID. Creating a monitor uses the host's events/subscribe capability after discovering supported camera events; these tools never accept callback URLs or signing keys.

Inputs: cursor. Returns: object

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      C
      maintenance
      A local MCP server that lets AI assistants list and control home devices — lights, air conditioners, cameras, speakers, plugs and scheduled tasks — across Xiaomi (Mi Home), Tuya, Midea, eWeLink (Sonoff) and Huawei SmartHome using accounts you authorize on your own machine. It binds to localhost only and communicates with each vendor cloud, so agents can act on devices through natural language.
      27 npm
      2
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Connects AI assistants to Home Assistant, enabling them to discover and control smart home entities, services, areas, devices, and cameras via the Model Context Protocol.
      4
      BSD 3-Clause
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables AI agents to discover, read and control smart-home devices from multiple vendors through a unified capability model, and to author and trigger YAML scenes that a local deterministic engine executes without the AI in the control loop. High-risk actions such as door locks and garage doors are held in a confirmation queue for a human, and every call is written to a local audit log.
      Apache 2.0
    Try in Browser

    Glama MCP Gateway

    Add one secure layer between your agents and this server.

    Resources