Skip to content

guilherme-vasques-ltda/titanos-mcp

v0.3.0MIT

Installs the official Titanos OAuth MCP server plus operating skills for marketplace, Amazon, listings, research and safe writes.

GitHubOpen Website

Titanos MCP for Hermes

Agent Plugin v1 package that installs the official @titanos/mcp-agents MCP server and Titanos operating skills in Hermes.

One install provides:

  • OAuth MCP connection to the live Titanos tools.
  • Product and keyword research guidance.
  • Amazon Seller, listings, and Ads guidance.
  • Mercado Livre, Olist, Bling, Shopee, and Titanos Core guidance.
  • Safety rules for every write-capable operation.

Hermes discovers the bundled skills automatically inside a collision-safe plugin namespace. No separate skill installation is required. In Skills, their names end with:

  • titanos-mcp
  • titanos-miner
  • titanos-seller-operations
  • titanos-listings
  • titanos-amazon-ads
  • titanos-marketplace-operations
  • titanos-safe-writes

The visible prefix is generated by Hermes for portable plugins and may look like agent-plugin-titanos-mcp-…:.

It does not contain a token, API key, .env file or a custom backend. Authentication uses the OAuth flow provided by the Titanos MCP client. The empty TITANOS_API_KEY value in mcp.json clears inherited legacy keys; it is not a credential.

Requirements

  • Hermes Agent with Agent Plugins v1 support.
  • Node.js 20.18.1 or newer and npx available on the machine running Hermes.
  • A Titanos account allowed to authorize the requested MCP scopes.

Authenticate Titanos

Run once on the same computer where Hermes runs:

npx -y @titanos/mcp-agents@1.47.2 login

Complete the browser authorization. Check the saved connection without exposing a token:

npx -y @titanos/mcp-agents@1.47.2 status

Install in Hermes Desktop

  1. Open Capabilities → Plugins → Install from Git.
  2. Enter guilherme-vasques-ltda/hermes-plugin-titanos.
  3. Review the package and install it. Keep it disabled until the Titanos OAuth connection exists.
  4. Enable titanos-mcp in Capabilities → Plugins.
  5. Start a new Hermes chat or run /reset so the MCP tools are discovered.

Install with the CLI

For the active Hermes profile:

hermes plugins install guilherme-vasques-ltda/hermes-plugin-titanos --no-enable
hermes plugins enable titanos-mcp

Use hermes -p <profile> in place of hermes to install into a specific profile.

Verify

hermes plugins list --plain --no-bundled
hermes plugins show titanos-mcp

Open a fresh Hermes session and ask it to use a Titanos MCP tool. The first startup downloads the pinned MCP package if it is not already in the npm cache.

Update

This package pins the MCP server at 1.47.2. Updating the server is a repository change: update mcp.json, tests and documentation together, then publish a reviewed release.

Remove

hermes plugins disable titanos-mcp
hermes plugins remove titanos-mcp

To revoke the local Titanos authorization afterwards:

npx -y @titanos/mcp-agents@1.47.2 logout

License

MIT. See LICENSE.