All plugins

Certified

adaption

Dataset import, adaptation, augmentation, translation, localization, synthetic generation (Invent), and AutoScientist fine-tuning through Adaption's hosted MCP server, with three workflow skills bundled. Agent Plugins v1 package (plugin.json + mcp.json + skills/), configuration only. Disclosure — every tool call goes to Adaption's hosted server (api.prod.adaptionlabs.ai) and acts on the user's Adaption account, tagged with a fixed hermes-plugin source parameter and header; the tool set is served by that server at runtime and is not covered by the pinned sha. Sign-in runs the pinned mcp-remote@0.1.49 through npx (Node.js 20.18.1+ and npm required; its own npm dependencies resolve to their latest matching versions at first run) with Adaption's pre-registered public OAuth client, which opens a browser and a local callback port on first use and stores OAuth tokens under ~/.mcp-auth. Launching runs spends Adaption credits; the package marks the server untrusted, so Hermes asks before every tool the server does not mark read-only (including cost estimates) and refuses them in unattended runs.

adaptionlabs3Toolsv0.3.0Updated 15 days ago

About

Dataset import, adaptation, augmentation, translation, localization, synthetic generation (Invent), and AutoScientist fine-tuning through Adaption's hosted MCP server, with three workflow skills bundled. Agent Plugins v1 package (plugin.json + mcp.json + skills/), configuration only. Disclosure — every tool call goes to Adaption's hosted server (api.prod.adaptionlabs.ai) and acts on the user's Adaption account, tagged with a fixed hermes-plugin source parameter and header; the tool set is served by that server at runtime and is not covered by the pinned sha. Sign-in runs the pinned mcp-remote@0.1.49 through npx (Node.js 20.18.1+ and npm required; its own npm dependencies resolve to their latest matching versions at first run) with Adaption's pre-registered public OAuth client, which opens a browser and a local callback port on first use and stores OAuth tokens under ~/.mcp-auth. Launching runs spends Adaption credits; the package marks the server untrusted, so Hermes asks before every tool the server does not mark read-only (including cost estimates) and refuses them in unattended runs.

Adaption Plugin for Hermes Agent

Connect Hermes Agent to
Adaption for dataset management, fine-tuning, and
AutoScientist workflows.

The plugin is an Agent Plugins package, which
Hermes installs natively. It contains:

  • The Adaption MCP server, which gives Hermes the tools. You sign in with
    your Adaption account in the browser the first time it starts.
  • Three skills that teach Hermes how to use those tools.

Installation

The plugin connects through mcp-remote,
so it needs Node.js 20.18.1 or later and npm on your PATH.

Hermes Desktop

Open Capabilities → Plugins → Install from Git, enter
adaptionlabs/adaption-hermes-plugin, keep the agent plugin checked, and
confirm. Then enable adaption in the plugins list.

Or open this link, which only opens a confirmation dialog in Hermes Desktop:

hermes://plugin/install?repo=adaptionlabs/adaption-hermes-plugin&enable=1

Hermes CLI

hermes plugins install adaptionlabs/adaption-hermes-plugin --no-enable
hermes plugins enable adaption

Sign in

Sign in once before your first session:

npx -y -p mcp-remote@0.1.49 mcp-remote-client \
  'https://api.prod.adaptionlabs.ai/api/v1/mcp?source=hermes-plugin' \
  --transport http-only --header X-Adaption-Source:hermes-plugin \
  --static-oauth-client-info '{"client_id":"adaption-hermes-plugin"}'

In PowerShell, run it on one line through npx.cmd, with the inner quotes
escaped:

npx.cmd -y -p mcp-remote@0.1.49 mcp-remote-client 'https://api.prod.adaptionlabs.ai/api/v1/mcp?source=hermes-plugin' --transport http-only --header X-Adaption-Source:hermes-plugin --static-oauth-client-info '{\"client_id\":\"adaption-hermes-plugin\"}'

Your browser opens the Adaption sign-in page. Choose the organization and
click Authorize. The token is stored and refreshed, so the plugin's server
connects without a browser from then on. Start a new session, or run
/reload-mcp in a running one, and run skills_list to see the Adaption
skills.

If you skip this step, the server opens the sign-in page when a session
starts, but Hermes stops waiting for it after about a minute. If that happens,
run the command above, then /reload-mcp.

To sign out or switch to another organization, delete the stored token and
sign in again:

rm ~/.mcp-auth/mcp-remote-0.1.49/68a9ef231d47fe56f4f1b863f1349fa4_*

Approvals

The plugin marks the server untrusted, so Hermes asks before every tool the
server does not mark read-only. Adaption marks the tools that list and inspect
datasets, runs, models, and domains as read-only; they run without asking.
Hermes asks before import, adaptation, augmentation, translation,
localization, combining datasets, dataset generation, and AutoScientist runs.
In cron jobs and other unattended runs, those tools are refused.

Cost estimates use the same tools with estimate: true, so Hermes asks before
the estimate and again before the launch.

Headless use with an API key

For CI or a gateway with no one to complete a browser sign-in, use an Adaption
API key instead. Create one at
adaptionlabs.ai/app/settings,
then:

hermes mcp add adaption --url 'https://api.prod.adaptionlabs.ai/api/v1/mcp?source=hermes-plugin' --auth header

Answer yes when Hermes asks whether the server requires authentication, then
paste the API key when it asks for a bearer token. Hermes stores it in your
profile's .env as MCP_ADAPTION_API_KEY, not in config.yaml. To skip the
prompt, set MCP_ADAPTION_API_KEY in that .env before running the command.

A server named adaption in config.yaml replaces the plugin's server,
including its approval setting, so the skills keep working with the key. To
keep the approvals described above:

hermes config set mcp_servers.adaption.trust untrusted

Connecting without Node.js

Hermes can also sign in to the server itself, without mcp-remote. Add it to
config.yaml, which replaces the plugin's server:

hermes config set mcp_servers.adaption.url 'https://api.prod.adaptionlabs.ai/api/v1/mcp?source=hermes-plugin'
hermes config set mcp_servers.adaption.headers.x-adaption-source hermes-plugin
hermes config set mcp_servers.adaption.auth oauth
hermes config set mcp_servers.adaption.oauth.client_id adaption-hermes-plugin
hermes mcp login adaption

In Hermes Desktop, open this link instead and click Authenticate on the
adaption server:

hermes://mcp/install?name=adaption&config=eyJ1cmwiOiJodHRwczovL2FwaS5wcm9kLmFkYXB0aW9ubGFicy5haS9hcGkvdjEvbWNwP3NvdXJjZT1oZXJtZXMtcGx1Z2luIiwiaGVhZGVycyI6eyJYLUFkYXB0aW9uLVNvdXJjZSI6Imhlcm1lcy1wbHVnaW4ifSwiYXV0aCI6Im9hdXRoIiwib2F1dGgiOnsiY2xpZW50X2lkIjoiYWRhcHRpb24taGVybWVzLXBsdWdpbiJ9fQ

The oauth block is required: Adaption does not support dynamic client
registration, which Hermes falls back to without it. If you set the server up
this way before version 0.3.0 of the plugin, it keeps working; remove it with
hermes mcp remove adaption to switch to the plugin's server.

Local development

Hermes discovers packages in ~/.hermes/plugins/<name>/. Copy a checkout
there to test changes before they are pushed:

git clone https://github.com/adaptionlabs/adaption-hermes-plugin.git
rsync -a --delete --exclude .git adaption-hermes-plugin/ ~/.hermes/plugins/adaption/
hermes plugins enable adaption

Re-run rsync and start a new session after every change.

Features

📊 Dataset Management (11 tools)

  • Import datasets from HuggingFace, Kaggle, or Google Sheets
  • Adapt datasets with Adaption's processing pipeline
  • Augment datasets with synthetic domain/general rows
  • Translate and localize dataset content
  • Combine multiple datasets
  • Get export links for processed results

🎯 Fine-tuning (5 tools)

  • Browse available base models
  • Get hyperparameter recommendations
  • Launch AutoScientist training runs
  • Monitor training progress and results

🔬 Invent (2 tools)

  • Explore available domains and subdomains
  • Generate synthetic datasets from natural language descriptions

Available Skills

SkillDescription
adaption-datasetDataset import, processing, and transformation workflows
adaption-trainingAutoScientist training run management
adaption-inventSynthetic data generation with Invent

Example Usage

"List my Adaption datasets"

"Import this HuggingFace dataset and adapt it for fine-tuning"

"Start fine-tuning on my adapted dataset and pick a suitable base model"

"Generate 1000 customer service examples using Invent"

"Check the status of my training job"

What this plugin does on your machine

  • It runs the pinned mcp-remote@0.1.49 through npx, which downloads it
    from npm on first use. On first sign-in it opens a browser and a local
    callback port, and it stores the OAuth tokens under ~/.mcp-auth/.
  • Every tool call goes to api.prod.adaptionlabs.ai and acts on your Adaption
    account. The tool set is served by Adaption at run time and is not covered
    by the pinned commit. Datasets you import or generate are processed by
    Adaption.
  • Adaptation, augmentation, translation, localization, dataset generation, and
    AutoScientist training runs spend Adaption credits. Hermes asks before each
    of those calls (see Approvals), and the skills tell Hermes to
    request a cost estimate first.
  • The skills are Markdown instructions. The plugin ships no Python code, hooks,
    or background processes beyond the mcp-remote bridge while a session runs.

Requirements

  • Hermes Agent 0.21.6 or later (hermes update to get the latest)
  • Node.js 20.18.1 or later and npm, unless you connect without Node.js
  • An Adaption account

Support

License

MIT License - see LICENSE for details.

README from the reviewed commit 3ab5264; it updates when the author re-pins.

Developer Mode

Explore built-in Hermes toolsets and actions.

HermesAgent

Developer?

Create a Hermes extension for Desktop or agent workflows.

Developer Section