# Seam — MCP server on mcp.ai
> Connect your Seam account and use 10 tools for internet of things straight from your AI agent. Connect with your own API key. Control smart locks, access systems, thermostats, sensors, and other connected devices in a Seam workspace.

By: mcp.ai · official
Page: https://mcp.ai/seam

## Connect (MCP protocol)
Remote MCP endpoint (HTTP, streamable): https://api.mcp.ai/p_seam?ms=1787293620000
Add it as a custom/remote MCP connector, then authenticate when prompted.

## REST API (no MCP client required)
Every tool is also a REST endpoint, authed with a workspace API key.
Discover: GET https://api.mcp.ai/api/seam/_endpoints   # public; lists every endpoint
Call:     POST https://api.mcp.ai/api/seam/<endpoint>
  Authorization: Bearer sk_live_…   # create one at https://mcp.ai/settings/api-keys
  Content-Type: application/json
  Body: { …args }   →   { "ok": true, "tool": "<id>", "result": { … } }

## Developer docs
How to use (MCP or REST), markdown: https://mcp.ai/seam/skill.md
Postman collection (v2.1): https://mcp.ai/seam/postman.json

## Tools
- seam_add_access_methods_to_grant(access_grant_id: string, requested_access_methods: object[]) — Request additional PIN, card, mobile-key, or cloud-key methods for an existing access grant.
- seam_create_access_grant(name?: string, ends_at?: string, space_ids?: string[], starts_at?: string, device_ids?: string[], space_keys?: string[], user_identity?: object, reservation_key?: string, access_grant_key?: string, acs_entrance_ids?: string[], user_identity_id?: string, customization_profile_id?: string, requested_access_methods: object[]) — Grant an existing or new user identity access to spaces, devices, or access-control entrances, requesting PIN, card, mobile-key, or cloud-key methods.
- seam_delete_access_grant(access_grant_id: string) — Permanently revoke and delete an access grant by UUID, removing the access it manages.
- seam_get_access_grant(access_grant_id?: string, access_grant_key?: string) — Get one access grant by its Seam UUID or unique workspace key.
- seam_list_access_grants(limit?: integer, space_id?: string, device_id?: string, page_cursor?: string, customer_key?: string, acs_system_id?: string, access_code_id?: string, acs_entrance_id?: string, reservation_key?: string, access_grant_ids?: string[], access_grant_key?: string, user_identity_id?: string, without_access_grant_key?: boolean) — List access grants in the workspace, optionally filtered by space, device, entrance, user identity, reservation, customer, key, or IDs; returns one cursor-controlled page.
- seam_list_action_attempts(limit?: integer, device_id?: string, page_cursor?: string, action_attempt_ids?: string[]) — Inspect asynchronous Seam operation status, errors, and results in bulk by action-attempt IDs or by device, returning one cursor-controlled page.
- seam_list_connected_accounts(limit?: integer, search?: string, space_id?: string, page_cursor?: string, customer_key?: string, custom_metadata_has?: object, user_identifier_key?: string) — List and search provider accounts connected to the workspace, optionally filtering by space, customer, user, or metadata; returns one cursor-controlled page.
- seam_list_devices(limit?: integer, search?: string, space_id?: string, device_ids?: string[], device_type?: string, page_cursor?: string, customer_key?: string, device_types?: string[], manufacturer?: string, created_before?: string, connect_webview_id?: string, custom_metadata_has?: object, user_identifier_key?: string, connected_account_id?: string, connected_account_ids?: string[]) — List and search devices in the workspace, optionally filtering by account, space, IDs, type, manufacturer, customer, creation time, or metadata; returns one cursor-controlled page.
- seam_list_spaces(limit?: integer, search?: string, space_key?: string, page_cursor?: string, customer_key?: string) — List and search spaces in the workspace by name, key, or customer, returning one cursor-controlled page of grantable locations.
- seam_update_access_grant(name?: string, ends_at?: string, starts_at?: string, access_grant_id?: string, access_grant_key?: string) — Update an access grant's name or validity window by UUID or unique workspace key. Provide at least one of name, starts_at, or ends_at.

## Example prompts
- "What can I do in Seam?"
- "Show me a summary of my Seam account"

## Links
Docs: https://mcp.ai/docs/mcps/seam
Website: https://mcp.ai/mcps/seam