ud-freshdesk-mcp
v0.1.0
Published
Freshdesk MCP server (stdio) — per-agent Freshdesk API v2 access. Zero runtime dependencies. Key from FRESHDESK_API_KEY or ~/.ud-support/freshdesk.key.
Readme
Freshdesk MCP server (local, zero-dependency)
A single-file Node stdio MCP server exposing the Freshdesk API v2 as the individual agent.
- Runtime: Node 18+ (uses global
fetch). No npm dependencies, nothing to build. - Published as
ud-freshdesk-mcp. Install once:npm install -g ud-freshdesk-mcp→ provides theud-freshdesk-mcpcommand (used by the Canopy MCP flow as a Command server).npx -y ud-freshdesk-mcpalso works. - Credentials (either works, env first):
FRESHDESK_API_KEYenvironment variable, or~/.ud-support/freshdesk.key— achmod 600file containing just the key. Use the file when running under Canopy: Canopy does not pass its Environments vars into the spawned MCP subprocess, and won't persist a${...}reference in the server config, so the file is the reliable per-agent path (and keeps the key out of any shared config).FRESHDESK_DOMAINdefaults tounstoppabledomains.
- Tools:
get_ticket,get_ticket_conversations,list_tickets,search_tickets,reply_to_ticket,add_private_note,update_ticket,search_kb_articles.
Run tests: node --test
