Freshdesk MCP server

Instructions

Implementation Reference

• src/freshdesk_mcp/server.py:559-577 (handler)

  The main handler function for the 'create_canned_response' tool. It validates input using CannedResponseCreate model, makes a POST request to Freshdesk API to create the canned response, and returns the response.
  @mcp.tool() async def create_canned_response(canned_response_fields: Dict[str, Any])-> Dict[str, Any]: """Create a canned response in Freshdesk.""" # Validate input using Pydantic model try: validated_fields = CannedResponseCreate(**canned_response_fields) # Convert to dict for API request canned_response_data = validated_fields.model_dump(exclude_none=True) except Exception as e: return {"error": f"Validation error: {str(e)}"} url = f"https://{FRESHDESK_DOMAIN}/api/v2/canned_responses" headers = { "Authorization": f"Basic {base64.b64encode(f'{FRESHDESK_API_KEY}:X'.encode()).decode()}" } async with httpx.AsyncClient() as client: response = await client.post(url, headers=headers, json=canned_response_data) return response.json()
• src/freshdesk_mcp/server.py:149-163 (schema)

  Pydantic model defining the input schema for creating a canned response, used for validation in the handler.
  class CannedResponseCreate(BaseModel): title: str = Field(..., description="Title of the canned response") content_html: str = Field(..., description="HTML version of the canned response content") folder_id: int = Field(..., description="Folder where the canned response gets added") visibility: int = Field( ..., description="Visibility of the canned response (0=all agents, 1=personal, 2=select groups)", ge=0, le=2 ) group_ids: Optional[List[int]] = Field( None, description="Groups for which the canned response is visible. Required if visibility=2" )
• src/freshdesk_mcp/server.py:559-559 (registration)

  The @mcp.tool() decorator registers the create_canned_response function as an MCP tool with the name 'create_canned_response'.
  @mcp.tool()