Getting startedBuild With AgentsAgent Harnesses

Hermes Agent

View as MarkdownOpen in Claude

The You.com plugin for Hermes Agent, the open-source agent from Nous Research, installs four skills and the You.com MCP servers from the agent-skills repo. It ships as a portable Agent Plugins package. The MCP servers give Hermes tools such as you-search, you-contents, you-research, and you-finance. The skills tell it when to use each one and how to cite what it finds.

Install the Docs MCP server

The Docs MCP server lets your agent search over the entirety of these docs. Free to use.

Install https://you.com/docs/_mcp/server. See the Docs MCP Server guide to learn more.

Install the Plugin

1

Install and Enable

hermes plugins install youdotcom-oss/agent-skills
hermes plugins enable you

Hermes installs portable plugins disabled. The install command asks whether to enable it and defaults to no, so run hermes plugins enable you if you skipped that prompt. Because the plugin installs from GitHub instead of the Hermes plugin catalog, Hermes also shows an unreviewed-source warning.

2

Sign In

The you, you-research, and you-finance servers sign in with your You.com account over OAuth. If one asks for authorization, run hermes mcp login <server-name>, such as hermes mcp login you, or click Authorize on the server in Hermes Desktop.

3

Try It

Use you-web to find what's new in the latest TypeScript release, with sources.

What the Plugin Installs

MCP servers. Hermes names each tool mcp__<server>__<tool>, such as mcp__you__you-search:

ServerEndpointAuth
youhttps://api.you.com/mcpOAuth
you-researchhttps://api.you.com/mcp/researchOAuth
you-financehttps://api.you.com/mcp/financeOAuth
you-discoverhttps://api.you.com/mcp?profile=discoverNone

Skills.

SkillUse it for
you-webCurrent web search and URL reading, with sources cited. Switches to keyless you-search when no credentials are set.
you-researchChoosing between agent-led searching and a single cited you-research call
you-financeFinance questions through the you-finance tool
you-discoverFinding the right You.com API, MCP server, or SDK for a project you’re building

Use the MCP Server Without the Plugin

To add only the tools, without the skills, add the You.com MCP server under mcp_servers in ~/.hermes/config.yaml. Run /reload-mcp or start a new session to load it.

Free profile (you-search and you-discover, 100 queries per day, no account):

mcp_servers:
  you-com:
    url: "https://api.you.com/mcp?profile=free"

API key. Get a key at you.com/platform:

mcp_servers:
  you-com:
    url: "https://api.you.com/mcp"
    headers:
      Authorization: "Bearer <YDC_API_KEY>"

Troubleshooting

Run hermes plugins list to check whether you is enabled. If it isn’t, run hermes plugins enable you, then start a new session.

Run hermes mcp login <server-name> and finish the sign-in in the browser, then run /reload-mcp.

Resources

Agent Skills

What each You.com skill does and how to install skills in other agents.

MCP Server Reference

Endpoints, authentication, and the full tool reference.