---
title: Hermes Agent remote MCP setup
description: Use Hermes Agent's documented HTTP and OAuth configuration to verify a first Phasoric project-context read.
slug: mcp-hermes
path: /mcp-hermes
section: MCP setup
availability: documented-setup
nav_order: 6.8
canonical_url: https://developers.phasoric.com/mcp-hermes
markdown_url: https://developers.phasoric.com/mcp-hermes.md
mirror_url: https://phasoric.com/developers/mcp-hermes
---
# Hermes Agent remote MCP setup

First [prepare a Phasoric vault](https://developers.phasoric.com/mcp-client-setup) on Premium or higher. Only explicitly authorized internet-reachable mappings are exposed; local-only vaults remain outside hosted MCP.

## Configure the owning profile

Hermes documents URL-based Streamable HTTP servers and OAuth. Merge this into the owning profile's existing configuration without replacing other entries:

```yaml
mcp_servers:
  phasoric:
    url: https://phasoric.com/api/mcp
    auth: oauth
    trust: untrusted
```

Run `hermes mcp login phasoric` from that profile and host. Review Phasoric's requested scopes and start with read access. The `untrusted` setting asks Hermes to require approval for tools without a read-only annotation; Phasoric's authorization checks still apply independently.

The official [MCP configuration reference](https://hermes-agent.nousresearch.com/docs/reference/mcp-config-reference), checked September 17, 2026, documents this transport, OAuth discovery and dynamic registration fallback. This configuration is a protocol-based inference, not a completed Hermes-to-Phasoric interoperability test.

## Check the useful result

Ask: “List my Phasoric vaults, then read the project brief and cite its path. Do not change anything.” Use the returned mapping handle. Confirm the actual read; tool discovery alone does not prove access.

Remote hosts need a working authorization callback. Consult the vendor's [remote-host OAuth guide](https://hermes-agent.nousresearch.com/docs/guides/oauth-over-ssh) for that setup.

To retain a reviewed outcome, follow Phasoric's [write-preview checks](https://developers.phasoric.com/mcp-client-setup). Conversations are not silently imported, and purchased hosted-intelligence credits do not unlock MCP.