integration-freshdesk

Connect Freshdesk support operations to a self-hosted Hermes agent via SSH.

13|1|Updated Jun 1, 2026
One-click install
npx skills add https://github.com/paarths-collab/hstack --skill integration-freshdesk
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: integration-freshdesk
Source: https://github.com/paarths-collab/hstack/tree/main/skills/integration-freshdesk
Command: npx skills add https://github.com/paarths-collab/hstack --skill integration-freshdesk

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill wires Freshdesk into a self-hosted Hermes agent so support teams can manage tickets without manual copying, repetitive setup, or brittle one-off integrations.

Core Features & Use Cases

  • SSH-first deployment: Configures the integration on a remote VPS where Hermes is running, keeping secrets and gateway changes on the host.
  • MCP or REST fallback: Uses Freshdesk’s first-party MCP path when available, and falls back to the v2 REST API when the EAP route is unavailable.
  • Safe operational workflow: Includes idempotency checks, dry-run preview, log verification, smoke testing, and rollback guidance.
  • Use case: An AI coding agent can connect Freshdesk so it can triage, read, create, and update tickets, contacts, and companies on behalf of the user.

Quick Start

Ask the agent to connect Freshdesk for your Hermes VPS by providing the VPS address, SSH user, Freshdesk domain, and API key, then let it run the setup, verification, and gateway reload steps.

Frequently Asked Questions about integration-freshdesk

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I connect Freshdesk to a self-hosted Hermes agent via SSH?

Connect Freshdesk to Hermes by providing your VPS address, SSH user, Freshdesk domain, and API key. The agent runs SSH-first setup steps, configures MCP or REST fallback, reloads the gateway, and verifies the API smoke test.

Can I manage Freshdesk support tickets from an AI coding agent like Claude Code or Cursor?

Yes, AI coding agents like Claude Code, Codex, Cursor, and Gemini CLI can triage, read, create, and update Freshdesk support tickets, contacts, and companies once the SSH integration to your Hermes VPS is configured.

Does the Freshdesk Hermes integration use the MCP protocol or the REST API?

The integration uses Freshdesk's first-party MCP path when available, and falls back to the Freshdesk v2 REST API when the EAP route is unavailable, ensuring continuous support ticket management.

What is needed to set up Freshdesk integration on a remote VPS?

Setting up Freshdesk on a remote VPS requires SSH access, VPS-side secret storage for the API key, raw Authorization header handling without Bearer, MCP registration, gateway reload, and API smoke verification.

How does the Freshdesk SSH integration handle rollback and deployment safety?

The integration includes safe operational workflow features like idempotency checks, dry-run previews, log verification, smoke testing, and rollback guidance to prevent brittle or repetitive setup errors.

Why does my Freshdesk API integration require raw Authorization headers without Bearer?

Freshdesk's API authentication uses a raw Authorization header without the Bearer prefix. Handling this correctly during VPS-side secret storage and gateway configuration ensures successful MCP registration and API access.