Build with Hermes Agent. Automate device tasks in your application.

Use Hermes to build workflows with Seam. Connect the current documentation first, then build application logic that records state, handles failures, and verifies each result.

Set up Hermes Agent Troubleshoot an issue

Hermes Agent

Illustrative sandbox workflow

Set up Seam in Hermes Agent.

Hermes supports hosted MCP servers through its YAML configuration and discovers their tools when a session starts.

01

Add the Seam server

Merge this entry into mcp_servers in ~/.hermes/config.yaml. Keep your existing servers and configuration.

~/.hermes/config.yaml

mcp_servers:
  seam:
    url: "https://mcp.seam.co/mcp/authenticated"
    auth: oauth

Sign in with OAuth in the next step. No Seam API key is needed.

02

Refresh the connection

Run hermes mcp login seam in a fresh terminal and complete browser sign-in. Then start a new Hermes chat or run /reload-mcp. Ask Hermes to search Seam’s current device-capability documentation and return the source it used.

Run in a fresh terminal

hermes mcp login seam

03

Prepare your application

Paste the setup prompt into a session with access to your project. It points to /agents.md for instructions on setting up your application’s Seam API key and your delegated agent connection.

Seam agent setup

Paste into Hermes

Set up Seam in this project:
fetch https://seam.co/agents.md and follow its instructions.

Choose your workspace permissions.

After signing in, check that api_request appears alongside the documentation tools. Ask your agent to list your workspaces. If Seam returns a permission-consent link, open it, select the intended scope and Viewer for read-only access, then retry. Device changes require write permissions. No Seam API key belongs in this MCP configuration.

Already connected? Replace the old Seam entry instead of adding a duplicate, reconnect or restart your client, and start a new conversation to refresh its tools. For documentation and skill packs without sign-in, use https://mcp.seam.co/mcp instead and skip OAuth login. This optional anonymous connection cannot access workspace resources.

Read the MCP guide

Troubleshoot with your agent.

Investigate device and connected-account issues, Access Grants, access codes, and API or authentication errors. Seam’s MCP delivers the troubleshooting skill pack directly to your agent, with playbooks for gathering evidence and identifying what is still unknown.

Connect with Viewer access.

Use an MCP client that supports OAuth to connect to Seam’s authenticated endpoint. Sign in and approve Viewer access to the workspace you want to investigate. Refresh the connection and start a new conversation to load its tools.

Use your existing workspace. This skill is available through MCP without a separate plugin install. Replace the placeholders with the affected resource, workspace, and incident time. The investigation uses public API evidence and stays read-only.

Set up troubleshooting

Authenticated MCP endpoint

https://mcp.seam.co/mcp/authenticated

Try this prompt

Use Seam MCP to investigate why access grant <grant_id>
in workspace <workspace_id> failed at <time and timezone>.
Use the troubleshooting skill pack. Keep the investigation
read-only and explain any missing evidence.

Prompts to try.

Give Hermes Agent a concrete task, ask it to check current documentation, and review the result.

Build a device health report

Agent prompt

Use Seam’s current device and connection documentation to build a read-only health report in this project. Group disconnected accounts, offline devices, and unsupported operations separately, and show the evidence behind each result.

Make an access workflow repeatable

Agent prompt

Implement a repeatable guest-access workflow using the current Seam API guidance. Record which reservation and grant each operation belongs to, reconcile pending results, and test changes and cancellations in a sandbox.

Document an operational recovery path

Agent prompt

Inspect our Seam integration and write a recovery procedure for a failed access operation. Use current API references to identify what to read first, when a retry is appropriate, and what evidence an operator needs before taking action.

Questions.

Client setup references

Hermes MCP setup ↗Hermes skills ↗Seam agent setup ↗Seam integration skills ↗

How do I make new MCP settings take effect?

Start a new session or run /reload-mcp. Hermes reloads the configured connections and refreshes the tools. Verify the change with a documentation request in the session that will use Seam.

Can Hermes reuse Seam’s integration skills?

Yes. For Access Grants, run hermes skills install seamapi/seam-plugin/skills/seam-access-grants. Hermes supports installation from a GitHub skill directory with its supporting files. Confirm the installed skill appears in the active session before starting the integration.

Next steps.

Test in a sandbox, then connect your real devices.

Find your device

Get an API key All agent guides

Build with Hermes Agent. Automate device tasks in your application.

Set up Seam in Hermes Agent.

Add the Seam server

Refresh the connection

Prepare your application

Troubleshoot with your agent.

Connect with Viewer access.

Prompts to try.

Build a device health report

Make an access workflow repeatable

Document an operational recovery path

Questions.

How do I make new MCP settings take effect?

Can Hermes reuse Seam’s integration skills?

Next steps.

Global Infrastructure for Controlling the Physical World